Bug 155642
Summary: | Enhacement tracker bug for FDP webpages | ||
---|---|---|---|
Product: | [Fedora] Fedora Documentation | Reporter: | Karsten Wade <kwade> |
Component: | project-tracking | Assignee: | Karsten Wade <kwade> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Tammy Fox <tammy.c.fox> |
Severity: | medium | Docs Contact: | |
Priority: | medium | ||
Version: | devel | CC: | eric, eric.rostetter |
Target Milestone: | --- | Keywords: | FutureFeature |
Target Release: | --- | ||
Hardware: | All | ||
OS: | Linux | ||
URL: | http://fedora.redhat.com/participate/documentation-guide/ | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Enhancement | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2009-10-30 17:54:16 UTC | Type: | --- |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Karsten Wade
2005-04-22 06:22:51 UTC
The following ideas have been suggested: * Better info on how to use CVS (probably pointing to another doc/page) * Better info on XML templates, use, tools/GUIs, and most importantly a tutorial, demo, or example. Maybe skeleton/template to get started on a new page with? * Specifically state that we will accept new docs in *any* format, and the FDP will then help convert it to the XML format, etc. * Specifically state that the inital doc author does not have to be the same as the maintainer. * Perhaps we need docs on a style guide, document format (required sections, etc). * We need a link on the web pages to the wiki. * Co-ordinate activity with Fedora Legacy Project in some way, not yet sure how. * Web page should have more information/pages such as: + Participation page (how to participate, etc) + Mailing list page (how to subscribe, link to archives, etc) + FAQ page * Spell out policies (like only accept docs about FC/Extras software, not 3rd party software, etc). Update FDP project page now includes: * Link to CVS Usage in Wiki (a draft doc, but a good URL) * States that any format accepted and conversion services offered * States that someone needs to maintain it, does not have to be the author * Provides overall link to Wiki Page alread provides information on how to participate and a link to the mailing list. The Docs Project FAQ is very out of date, we need to review if that is a necessary item or not. Other process, style, tutorials, examples, and the like are being currently worked on and will be linked in when ready. Participation info is lacking in quality/quantity. Link to mailing list isn't sufficient IMHO, should have several links including a link to archives, and additional info about subscribe, unsubscibe, usage, expectations, etc. I forgot there was an FAQ when I wrote my inital bug entry, but there was, and the link to it is obvious on the front page, so my mistake there. Maybe change it to "improve/update FAQ". A lot of the stuff I posted could go in the faq (formats accepted, author and maintainer different, etc). I think this is being done elsewhere. |