273044 - Links to perl module download location moved into an appendix

Status: RESOLVED WONTFIX

(Bugzilla :: Documentation, defect)

Description

[Jacob Steenhagen]

At some point during the last year, the links to download locations for perl 
modules has been moved into the appendix of the Bugzilla Guide instead of being 
in the installation section. My thoughts are that it would be nice to have all 
that information in one place as it is really only useful in our context during 
the installation process.

Comment 1

[Jacob Steenhagen]

From an email on the Subject....

> Jake Wrote:
>> Shane Travis Wrote:
>> For the record, I understand the logic behind moving it into an Appendix.
>>  The manual is (supposed to be) about how to run Bugzilla, not how to
>> install Perl.  The information about what you need to run bugzilla (i.e.
>> which modules are required) should be -- and is -- right there at your
>> fingertips in the installation section.  'How to compile a perl module' is
>> certainly crucial information for someone who doesn't know how to do it,
>> but placing it in its own appendix and referencing it properly is the
>> proper way to go IMHO, as it can be expanded as necessary without
>> intruding, and doesn't interrupt the main flow of installation
>> instructions for those who don't need it.
>
> Fair enough... though the links on where to get the modules and where the
> documentation on them is seems appropriate for the Installation chapter.
> And if that stuff is in there, the appendix becomes even shorter.  I'll
> have to give it some thought (or get more convincing arguments :).

Comment 2

[Dave Miller [:justdave]]

I suspect this was part of Gerv's reorg last spring

Comment 3

[Gervase Markham [:gerv]]

Probably.

This is information most people will not need, because most people use CPAN
rather than installing modules manually. Having it in an appendix means we don't
need to worry about giving lots of detail - we can do that without disrupting
the flow of the installation procedure.

Gerv

Comment 4

[Frédéric Buclin]

I agree with gerv. Most users don't need to download and compile Perl modules themselves. On Linux, their distros provide all the needed modules via their package manager. If a module is not available or is too old, install-module.pl will do the job for you. On Windows, PPM lets you easily install all needed Perl modules. So WONTFIX.