<div dir="ltr"><div>I live in hope, but....</div><div><br></div><div>I have just watched the video, <a href="http://www.blender.org/documentation/">http://www.blender.org/documentation/</a> given by Francesco Siddi and Cambell Barton. supposedly about documentation. </div><div><br></div><div>It was about technology to enable documentation, not about documentation.</div><div><br></div><div>There was a small piece near the end where the documentation process was mentioned, but mostly in a way that said... "er we have no idea, that's not our area."</div><div><br></div><div>At the end one guy in the audience asked what I believe was a practical non-tech questions, "How do I get involved and maybe write a couple of pages about a topic I know?"</div><div><br></div><div>The presenters responded with more tech because they were giving a presentation about technology, not a presentation about documentation.</div><div><br></div><div>The reply should have been.....</div><div><br></div><div>Contact this person by ..email, register at this address... state what specific topic you think you can help on... you can write it in an email or whatever wordprocessor you like and then upload it on this webpage- Please contact the person responsible for that section of the manual - the list is on the webpage where you can upload the text.</div><div><br></div><div>Or something to that effect.</div><div><br></div><div><br></div><div>Another member of the audience stated the obvious - there has to be a style guide. </div><div><br></div><div><br></div><div><br></div><div>You guys have 'ported' (I would say 'copied') the old wiki into a new wiki - but the old wiki wasn't designed to work.</div><div><br></div><div>What you have is a technically slick, probably wonderfully engineered pigs ear.</div><div><br></div><div><br></div><div>I really, really don't want to annoy anyone saying this. I would like to see a good manual. Manuals are hard to create. Explaining in simple prose to someone who doesn't have a clue what you know is even harder.</div><div><br></div><div>The answer is not very tecky. It is social and literary. It requires social organization.</div><div><br></div><div>The tech part is an extremely easy input system (no downloads, no IRC, no archived cryptic stuff). </div><div>It requires a webpage that says how to register, a simple checklist or dialogue box to state what you feel capable of writing about and an email response from someone saying, </div><div>"Glad to have you on board, here's our style sheet and standard layout, send me your first draft whenever you can" </div><div><br></div><div>I live in hope....</div><div> </div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On 13 January 2015 at 20:29, Greg Zaal <span dir="ltr"><<a href="mailto:gregzzmail@gmail.com" target="_blank">gregzzmail@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div>Hi Marco,<br><br>I've just updated the Windows install instructions here: <a href="http://blender.org/manual/about/install/windows.html" target="_blank">http://blender.org/manual/about/install/windows.html</a><br><br></div>Let me know if you have any issues following that :)<br><br>Cheers,<br></div>Greg<br></div><div class="gmail_extra"><br><div class="gmail_quote">On 13 January 2015 at 19:35, marco ardito <span dir="ltr"><<a href="mailto:ardito@apiform.to.it" target="_blank">ardito@apiform.to.it</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;padding-left:1ex;border-left-color:rgb(204,204,204);border-left-width:1px;border-left-style:solid"><u></u>
<div text="#000000" bgcolor="#ffffff">
trying to get manual source on my win7x64sp1 work pc...<br>
after installing svn, and ckecked out trunk, then <br>
get python 1.7 with msi installer.... now?<br>
<br>
<a href="http://www.blender.org/documentation/get-started" target="_blank">http://www.blender.org/documentation/get-started</a> page says:<br>
<br>
"Make sure you have Python 2.7 installed and get the virtualenv
tool:<code> pip install virtualenv</code>"<br>
<br>
well I have Python 2.7 installed now, but where should I type "pip
install virtualenv" ?<br>
at the command line... (ie for me d:\python27) "pip install
virtualenv" is not working...<br>
<br>
help please...<span class="HOEnZb"><font color="#888888"><span><font color="#888888"><br>
<br>
<code></code>-- <br>
<div>
<div>
<div><b>Marco <br>
</b></div>
</div>
</div>
<br>
<blockquote> -------------------
[Ai sensi e per gli effetti della Legge sulla tutela della privacy
(L. 196/2003), questa mail è destinata unicamente alle persone sopra
indicate e le informazioni in essa contenute sono da considerarsi
strettamente riservate. E' proibito leggere, copiare, usare o
diffondere il contenuto della presente mail senza autorizzazione.
Se avete ricevuto questo messaggio per errore, siete pregati di
rispedire la stessa al mittente. Grazie]
</blockquote>
</font></span></font></span></div><span class="HOEnZb"><font color="#888888">
<br>_______________________________________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org" target="_blank">Bf-docboard@blender.org</a><br>
<a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
<br></font></span></blockquote></div><br></div>
<br>_______________________________________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
<a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
<br></blockquote></div><br></div>