[RFC] DocsRawhide enhancements

Rahul Sundaram sundaram at redhat.com
Wed Dec 7 10:36:30 UTC 2005


Karsten Wade wrote:

>The DocsRawhide (rawhide of documentation) beta has been live for a
>little while:
>
>http://webtest.fedora.redhat.com/docs/
>
>There are many purposes this basic technology can be used for.
>
>At it's core, it checks out the latest content from CVS and builds it at
>static URLs.
>
>This is fully draft, may burn your computer documentation.  It's purpose
>is to let anyone view what is in CVS without needing a build
>environment.
>
>What are your ideas of what to do with this tool?  What should we make
>it do?
>  
>
My original idea behind the suggestion was to enhance visibility to the 
documentation in progress and potentially get more reviewers and 
contributors and bring in transparency to the project.  Fedora 
Documentation could sit into a portal with links and search for the 
following information

* End user docs
* Printed books -  Fedora books from 
http://fedoraproject.org/wiki/Marketing/Books and perhaps 
http://www.redhat.com/magazine/013nov05/features/bookreview/,
* Red Hat magazine
* Manual and info pages - see 
http://fedoraproject.org/wiki/DocsProject/FedoraDocsSchedule
* In progress docs (docs rawhide) with appropriate warnings
* RPM Package lists with meta data information about the packages.

RPM The package descriptions in many cases are vague or outdated. I saw 
a reference to the SELinux  in the IRC meeting logs which applies RPM 
package descriptions too. The Fedora documentation project should  be 
accountable for the end user docs, man and info pages, keeping track of 
printed books and active involvement and coordination towards getting 
more such books published even from the formal Fedora docs. package 
description and website content etc to cover everything comprehensively.


regards
Rahul





More information about the docs mailing list