Bug #38713 for Catalyst-Manual: add links to Catalyst::Manual

Mon Aug 25 15:51:48 2008 EWILHELM [...] cpan.org - Ticket created

Subject:

add links to Catalyst::Manual

From http://catalystframework.org/ the "Documentation" link goes straight to http://search.cpan.org/perldoc?Catalyst::Manual, which means that this pod would likely be the first thing a potential new user would see when trying to determine "so, what is this thing?". The Catalyst/Manual.pm should contain more L<> references so that the user has something on which to click. Probably this means something like a table-of-contents (similar to what you see at "http://search.cpan.org/dist/Catalyst-Manual/", but ordered for optimal introductoryism.) --Eric

Mon Aug 25 18:02:38 2008 ZARQUON [...] cpan.org - Correspondence added

Fixed. The correct solution is to link to the correct catalyst::manual in the catalyst::runtime distribution. There is some complexity caused by splitting out separate ::Runtime ::Devel and ::Manual dists. Hopefully this is the last in a long line of bugs on this theme.

Mon Aug 25 18:02:40 2008 The RT System itself - Status changed from 'new' to 'open'

Mon Aug 25 18:02:41 2008 ZARQUON [...] cpan.org - Status changed from 'open' to 'resolved'

Mon Aug 25 18:03:13 2008 ZARQUON [...] cpan.org - Correspondence added

On Mon Aug 25 18:02:38 2008, ZARQUON wrote: Show quoted text

> Fixed. The correct solution is to link to the correct catalyst::manual > in the catalyst::runtime distribution. There is some complexity caused > by splitting out separate ::Runtime ::Devel and ::Manual dists. > Hopefully this is the last in a long line of bugs on this theme.

Oops, revision is at http://dev.catalystframework.org/svnweb/Catalyst/revision?rev=8287

Mon Aug 25 18:03:15 2008 The RT System itself - Status changed from 'resolved' to 'open'

Mon Aug 25 18:05:06 2008 ZARQUON [...] cpan.org - Correspondence added

On Mon Aug 25 18:03:13 2008, ZARQUON wrote: Show quoted text

> On Mon Aug 25 18:02:38 2008, ZARQUON wrote:

> > Fixed. The correct solution is to link to the correct catalyst::manual > > in the catalyst::runtime distribution. There is some complexity caused > > by splitting out separate ::Runtime ::Devel and ::Manual dists. > > Hopefully this is the last in a long line of bugs on this theme.

> > > Oops, revision is at > http://dev.catalystframework.org/svnweb/Catalyst/revision?rev=8287

double oops, the correct revision is http://dev.catalystframework.org/svnweb/Catalyst/revision?rev=8288

Mon Aug 25 18:18:10 2008 EWILHELM [...] cpan.org - Correspondence added

On Mon Aug 25 18:02:38 2008, ZARQUON wrote: Show quoted text

> Fixed. The correct solution is to link to the correct >catalyst::manual in the catalyst::runtime distribution.

Well, that fixes the link from the catalystframework site, but anyone who lands on the Catalyst-Manual version of Catalyst::Manual is still going to be left scratching their head (and even more confusing there are two Catalyst/Manual.pm files!? Either get the indexer straight or something (I suspect that the .pm file causes trouble, especially with the new one not bearing a $VERSION.) In short, still not fixed: http://search.cpan.org/search?module=Catalyst%3A%3AManual

Wed Oct 08 18:53:48 2008 janus [...] errornet.de - Correspondence added

From:

janus [...] errornet.de

On Mon Aug 25 18:18:10 2008, EWILHELM wrote: Show quoted text

> On Mon Aug 25 18:02:38 2008, ZARQUON wrote:

> > Fixed. The correct solution is to link to the correct > >catalyst::manual in the catalyst::runtime distribution.

> > Well, that fixes the link from the catalystframework site, but anyone > who lands on the Catalyst-Manual version of Catalyst::Manual is still > going to be left scratching their head (and even more confusing there > are two Catalyst/Manual.pm files!? Either get the indexer straight or > something (I suspect that the .pm file causes trouble, especially with > the new one not bearing a $VERSION.) > > In short, still not fixed: > > http://search.cpan.org/search?module=Catalyst%3A%3AManual

I totally agree, especially from a porters point of view where you have to decide for one of those two Manual.pm's to avoid conflicts in the resulting packages. So it's definitely not ppm's problem like written in the changelog.

Sat Feb 28 11:32:52 2009 HKCLARK [...] cpan.org - Correspondence added

See: http://dev.catalystframework.org/svnweb/Catalyst/revision?rev=9343 Hopefully that represents enough in the way of getting started links to not leave new users stranded.

Sat Feb 28 11:32:54 2009 HKCLARK [...] cpan.org - Status changed from 'open' to 'resolved'