File Coverage

blib/lib/Task/Sites/ShlomiFish.pm
Criterion Covered Total %
statement 8 8 100.0
branch n/a
condition n/a
subroutine 3 3 100.0
pod n/a
total 11 11 100.0


line stmt bran cond sub pod time code
1             package Task::Sites::ShlomiFish;
2              
3 2     2   177161 use warnings;
  2         5  
  2         69  
4 2     2   11 use strict;
  2         5  
  2         38  
5              
6 2     2   41 use 5.014;
  2         8  
7              
8             =head1 NAME
9              
10             Task::Sites::ShlomiFish - Specifications for modules needed for building www.shlomifish.org , whose sources are publically available, and which serves as examples for several technologies.
11              
12             =cut
13              
14             our $VERSION = '0.0213';
15              
16             =head1 DESCRIPTION
17              
18             Shlomi Fish maintains a homesite at L<http://www.shlomifish.org/>. Installing
19             this task from CPAN will install all of the CPAN modules that are required
20             to build it.
21              
22             The sources of this web-site are available in a public version control
23             repository with detailed building instructions:
24              
25             L<http://www.shlomifish.org/meta/site-source/>
26              
27             This site serves as an example for the Latemp static site generator
28             ( L<http://web-cpan.shlomifish.org/latemp/> ) and for other open-source
29             technologies such as some of my XML-Grammar-* modules.
30              
31             =head1 AUTHOR
32              
33             Shlomi Fish, C<< <shlomif at iglu.org.il> >>
34              
35             =head1 BUGS
36              
37             Please report any bugs or feature requests to
38             C<bug-task-sites-shlomifish at rt.cpan.org>, or through the web interface at
39             L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Task-Sites-ShlomiFish>.
40             I will be notified, and then you'll automatically be notified of progress on
41             your bug as I make changes.
42              
43             =head1 DEFENSE OF THE MOTIVATION FOR THIS MODULE
44              
45             I received a lot of heat for maintaining this task on CPAN, which I feel
46             is unjustified. Part of the reason was that I did not make the justification
47             for it clear in the first versions I uploaded, so here it is.
48              
49             First of all, I should note that the source code of my site is public, and I
50             give detailed installation instructions here:
51              
52             L<http://www.shlomifish.org/meta/site-source/>
53              
54             So people who are interested may wish to download the site's sources, play with
55             them and learn from them.
56              
57             Furthermore, the sources of my site serve as a sophisticated example for Latemp
58             ( L<http://web-cpan.shlomifish.org/latemp/> ), Website Meta Language (
59             L<http://thewml.org/> ) and other technologies. So there is some public
60             motivation to make installing its CPAN dependencies as easy as possible.
61              
62             I'm sorry that I have not made all these facts clear in the module's
63             documentation, but I still feel that all the heat I received was uncalled for.
64              
65             After I said that, let me note that it is my opinion that if we don't want to
66             have CPAN "contaminated" with modules that are of little public use, then we
67             should implement a secondary sources mechanism in CPANPLUS.pm which will allow
68             configuring remote sources with their own indices, which will provide different
69             packages to what CPAN provides. Such mechanism will also allow organisations to
70             set up repositories for their own private use.
71              
72             Last time I raised the idea, someone objected and nothing was done to take it
73             forward. I'm willing to work on implementing it myself assuming there's enough
74             interest and that I'll know my effort will not go to waste.
75              
76             Now regarding the fact that this module wastes space on CPAN. Looking at my
77             CPAN directory, I see that the tar.gz of version 0.0201 of it occupies
78             2.1 KB. What a disaster! Seriously now, it occupies much less space than
79             "XML-Grammar-ProductSyndication" which takes 159KB, from "XML-RSS" which
80             takes 99 KB, from "Test-Run" which takes 83 KB, and from most of my other
81             modules. Obviously, there's some extra overhead in indexing and in displaying
82             on search engines, but taking it into proportion, it's not a burden on CPAN.
83              
84             =head1 SUPPORT
85              
86             You can find documentation for this module with the perldoc command.
87              
88             perldoc Task::Sites::ShlomiFish
89              
90             You can also look for information at:
91              
92             =over 4
93              
94             =item * AnnoCPAN: Annotated CPAN documentation
95              
96             L<http://annocpan.org/dist/Task-Sites-ShlomiFish>
97              
98             =item * CPAN Ratings
99              
100             L<http://cpanratings.perl.org/d/Task-Sites-ShlomiFish>
101              
102             =item * RT: CPAN's request tracker
103              
104             L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Task-Sites-ShlomiFish>
105              
106             =item * Search CPAN
107              
108             L<http://search.cpan.org/dist/Task-Sites-ShlomiFish>
109              
110             =back
111              
112             =head1 ACKNOWLEDGEMENTS
113              
114             =head1 SEE ALSO
115              
116             L<Task> , L<Task::Latemp>
117              
118             =head1 COPYRIGHT & LICENSE
119              
120             Copyright 2006 Shlomi Fish.
121              
122             This program is released under the X11 License:
123              
124             L<http://www.opensource.org/licenses/mit-license.php>
125              
126             =cut
127              
128             1;
129