<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Hi,<div><br></div><div><div><div>On 28.11.2012, at 13:59, Frank Karlitschek wrote:</div><blockquote type="cite"><div>we got the second question from a book publisher for an ownCloud book.<br>Is someone in the community interested in writing a book? ;-)<br></div></blockquote><br></div><div>Having been there before *):</div><div><br></div><div>* ownCloud is currently developing quite rapidly. If you want a hard-copy book, plan one for ownCloud 5, do not bother with 4.5</div><div>* at the same time, if we start a community effort to build a book (everyone is of course free to write a book alone and behind locked bars, but that requires a _lot_ of time and knowledge), skipping 4.5 would be king of sad, because currently our documentation is a bit... lacking.</div><div><br></div><div>That's why, at the meeting in Berlin, we created a documentation repository and a doc directory as part of the ownCloud desktop client, so we are currently having 4 manuals:</div><div><br></div><div> - one targeted at admins</div><div> - one for users</div><div> - one for developers hacking on (i.e. core) and for (i.e. apps) ownCloud</div><div> - one for the desktop client (to be shipped with it)</div><div><br></div><div>The results are then pushed to <a href="http://doc.owncloud.com/">http://doc.owncloud.com/</a> after every commit (with a latency of about 5-10 minutes, this could be reduced furth). We are using Sphinx (<a href="http://sphinx-doc.org/">http://sphinx-doc.org/</a>) with reStructuredText markup, which can be previewed and edited live in GitHub. Sphinx has been used to typeset books before, and can be used publish in a wide range of formats, from HTML and ebooks to PDF and PostScript, or even Windows Compiled Help (CHM).</div><div><br></div><div>However, what our users need right now, is good, up-to-date and reliable documentation for 4.5. That's why there is a master and a stable45 branch. Documentation applicable to both 4.5 and 5.0 should go to the 4.5 branch, things only applicable to 5.0 will only go to master.</div><div><br></div><div>All manuals are CC-licensed. Once these manuals are in good shape, it's easy to derive books from them.</div><div><br></div><div>So if you want to lend a helping hand, speak up! Bernhard is already doing the majority work on the dev manual and we have two Goole CodeIn jobs open related to moving the Wordpress-based documentation over. However there is still enough to do, so can always use helping hands, especially for the User and Admin manuals and for the Client.</div><div><br></div><div>Cheers,</div><div> Daniel</div><div><br></div><div>*) Disclaimer: I've done book-writing before, and I have done book layouting and e-book publishing.</div><br><div>
<div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>--</div><div><a href="http://www.owncloud.com">www.owncloud.com</a> - Your Data, Your Cloud, Your Way!</div><div><br>ownCloud GmbH, GF: Markus Rex, Holger Dyroff<br>Schloßäckerstrasse 26a, 90443 Nürnberg, HRB 28050 (AG Nürnberg)</div></div></div>
</div>
<br></div></body></html>