Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 89687 - user-contributed notes in Gentoo documentation as per php.net
Summary: user-contributed notes in Gentoo documentation as per php.net
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-04-19 11:05 UTC by John Nilsson
Modified: 2005-04-20 09:46 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description John Nilsson 2005-04-19 11:05:44 UTC
A feature that I think can enhance documentation tremendously is 'user-contributed notes' as the php documentation calls it.

All gentoo documentation should have an annotation feature along similar lines. The idea is that frome time to time the discussion is moderated by the document maintainers and any usefull information is incorporated into the actual manual page. New additions could be propagated by mail subscriptions and/or rss feeds for any interested parties.

Reproducible: Always
Steps to Reproduce:
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2005-04-20 03:22:14 UTC
We have neither the server back-end not the manpower for this.

FYI, doc improvement can be done by talking to us on #gentoo-doc (freenode) or on the gentoo-doc@gentoo.org mailing list and by creating bugs about improvements, or even better by submitting patches.
Comment 2 John Nilsson 2005-04-20 09:18:04 UTC
So there's server back-end for forums.gentoo.org but not for some doucument annotations...

What manpower would be needed? We are not talking about a support desk here, just annotations.
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2005-04-20 09:46:29 UTC
A few full-time documentation developers. These wouldn't "just be annotations", you'll have comments on the installation procedure you won't imagine. Check the forums already, the busiest one is on the installation. Even when I'm 24/24 I can't keep up with it :p