<html><head><style>body{font-family:Helvetica,Arial;font-size:13px}</style></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;"><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">Hello everyone,</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">an important update on the documentation migration:</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- we created a project on https://developer.blender.org/project/view/53/ </div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- the new sphinx-based documentation is available here https://developer.blender.org/diffusion/BM/</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">The project is now open for contribution, so we welcome any volunteer willing to check out the documentation and do content edits and structure refactoring for basically any section. General instructions on how to do this are available in the project description. At the moment, in order to contribute, there are a few requirements:</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- basic knowledge of GIT (checkout, commit, diff)</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- basic knowledge of Sphinx and reST (the documentation system)</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- an account on developer.blender.org (so you can write comments in the project tasks or raise issues there)</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">About translations and versioning:</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- currently we are trying to set up this documentation in English (many sections are unmaintained and some are outdated back to 2.4x)</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- if this migration succeeds, we will support other languages in parallel repos</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- currently we are working for the 2.7x series, and the idea is to use git-tags for greater versions</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">- older documentation will stay on wiki.blender.org until this documentation fully functional</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">We are happy to hear feedback and comments! Also, we are working on trying to make this infrastructure simpler, to easily allow casual contribution.</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">Reminder: this project is about the User Manual. Everything else (developers docs, proposals, release logs, module owners list, etc) will stay on the wiki.</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">Thanks,</div> <div id="bloop_sign_1409304812065094912" class="bloop_sign"><div style="font-family:helvetica,arial;font-size:13px">Francesco<br><br></div></div> <br><p style="color:#000;">On 3 Jul 2014 at 10:35:13, Campbell Barton (<a href="mailto:ideasman42@gmail.com">ideasman42@gmail.com</a>) wrote:</p> <blockquote type="cite" class="clean_bq"><span><div><div></div><div>On Thu, Jul 3, 2014 at 5:47 PM, marco ardito <ardito@apiform.to.it> wrote:<br>> Hi, campbell,<br>><br>> nice clean look! but... a TOC should be, well, a TOC, not a full index! :)<br>> look at the TOC page source. Something like that, with links... :) but<br>> that will be tuned later, I'm sure.<br><br>Yep, this needs cleaning up, basic structure is there but need to<br>change how top-level categories show.<br><br>Attempting to do this automatic isnt that valuable IMHO, once we do<br>final conversion re-arranging TOC isn't so hard.<br><br>> about the look, it's clean but it needs some tweaking. Great job, anyway<br>> for an automatic conversion!<br>><br>> I'm doing a wiki > pdf conversion since a while, updated each month. atm<br>> I stopped to see how the sphinx-doc trial went on, hoping that soon the<br>> old pdf could be no more needed!! great! converting the wiki in pdf is<br>> fun but also a pain :)<br><br>With sphinx we can provide the HTML as a downloadable archive, IMHO<br>this is more usable then the PDF,<br>I generated a PDF for our sphinx python reference for a while but it<br>wasnt that great, I removed and dont think anyone noticed.<br><br>> Do you have any pdf conversion test?<br><br>I did do one, but cant recall if I uploaded- It does an OK job, but<br>image layout sometimes doesn't look right.<br><br>Heres sphinx generated PDF, though there aren't any images.<br>http://www.blender.org/documentation/blender_python_api_2_59_0/blender_python_reference_2_59_0.pdf<br><br>To summarize we can have PDF book if we want, but I always found the<br>output inferior to the HTML docs.<br><br>> Thanks, Marco<br>><br>> Il 02/07/2014 23:29, Campbell Barton ha scritto:<br>>> Hi, quick update on the progress migrating the wiki,<br>><br>><br>><br>><br>> -------------------<br>> [Ai sensi e per gli effetti della Legge sulla tutela della privacy<br>> (L. 196/2003), questa mail รจ destinata unicamente alle persone sopra<br>> indicate e le informazioni in essa contenute sono da considerarsi<br>> strettamente riservate. E' proibito leggere, copiare, usare o<br>> diffondere il contenuto della presente mail senza autorizzazione.<br>> Se avete ricevuto questo messaggio per errore, siete pregati di<br>> rispedire la stessa al mittente. Grazie]<br>><br>> _______________________________________________<br>> Bf-docboard mailing list<br>> Bf-docboard@blender.org<br>> http://lists.blender.org/mailman/listinfo/bf-docboard<br><br><br><br>-- <br>- Campbell<br>_______________________________________________<br>Bf-docboard mailing list<br>Bf-docboard@blender.org<br>http://lists.blender.org/mailman/listinfo/bf-docboard<br></div></div></span></blockquote></body></html>