in reply to Re^3: An alternative Perldoc site
in thread An alternative Perldoc site
It's not interlinked.
F.ex, look at the perl POD page on perldoc.com: each POD page name it mentions is hyperlinked. Your version of perl has no links. Same goes for the “See also“ section of the POD pages on your site. Check the rendition of perlfunc on perldoc.com: the functions are all linked. Then click its link for unpack and compare with your version of the unpack documentation: on perldoc.com, the link actually leads to pack, on your site, it does nothing. That forces the user to constantly back out of his reading and delve into the navigation to locate where it is what they wanted to read, before being able to continue.
I realize providing such extensive linking requires non-trivial guessing in the general case and even special case guessing for some particular POD pages. I did write a POD-tree-to-HTML-tree converter myself, so I know it can be a pretty ugly job.
But not doing that greatly diminishes the value of the resulting docs, at least as far as I'm concerned.
Makeshifts last the longest.
|
|---|
| Replies are listed 'Best First'. | |
|---|---|
|
Re^5: An alternative Perldoc site
by jj808 (Hermit) on Mar 02, 2005 at 22:11 UTC | |
by Aristotle (Chancellor) on Mar 03, 2005 at 06:33 UTC | |
|
Re^5: An alternative Perldoc site
by jj808 (Hermit) on Jan 23, 2005 at 22:22 UTC |