Hello all.<br><br>I'd like to help improve the documentation for Trisquel and I think we need to define some things before we start to write more documents:<br><br>1. Contents of the Documentation Set<br>2. Writing process<br>
3. Where to start<br><br><br><br>1. Contents of the Documentation Set<br><br>First of all, I'd like to propose the following documentation set:<br><br><a href="http://introsmedia.tuxfamily.org/lab/trisquel/docs/doc-system.html">http://introsmedia.tuxfamily.org/lab/trisquel/docs/doc-system.html</a><br>
<br>As I say in the document above, that could be the main page that users would see when they click on the "Documentation" link in the website or when they go to "System → Help and Support" in the operating system.<br>
<br>I'm refering to users here, but since every user is a potential contributor, this documentation set also includes relevant information for anyone wondering how to contribute, and that's what the document at the end of the list is for. So, I see this main page as the entry point for anyone looking for information about Trisquel, its community, and its development process.<br>
<br><br><br>2. Writing process<br><br>I haven't thought much about this but my idea is that the writing process and the methodology used for other tasks such as artwork and development should be documented in the "Contributing Manual".<br>
<br>As we don't have any guidelines yet, I think we can start with a simple guideline based on what we have talked in #trisquel channel:<br><br>The main source for documentation would be the wiki and the default language would be English. Later, we could convert to DocBook any documentation we need to include in the system.<br>
<br><br><br>3. Where to start<br><br>I'm not familiar with the features of the wiki module for Drupal and I haven't found documentation for it, but I was thinking of leaving the current documentation as it is right now and start a new book in the wiki to define the new structure. Then, when the new structure is ready, we could start to reparent the current books and child pages.<br>
<br><br><br>What do you think?<br clear="all"><br>-- <br>Luis Felipe López Acevedo<br><a href="http://introsmedia.tuxfamily.org/">http://introsmedia.tuxfamily.org/</a><br>