[Bf-docboard] getting started on w7?

Fluff Rabbit fluffrabbit at aol.com
Tue Jan 13 23:49:20 CET 2015


... And that's why we'd also have the wiki for people who are not sure 
if they can contribute anything but try to nonetheless.

I'll admit, when I saw that video, I thought the manual would just be 
the new dumping ground, but when I found it was all but impossible to 
submit new content, I imagined Ton and the other software bureaucrats 
stroking themselves in the grand halls of version control. I think that 
your criticism is fair, though the reality of the situation is that 
these know-nothing users who would normally try to contribute to the 
wiki would instead be submitting each and every contribution to a dev 
via email. That doesn't sound appealing to me.

-----Original Message-----
From: Abuelo S. B. Chdancer <playadance at gmail.com>
To: Blender Documentation Project <bf-docboard at blender.org>
Sent: Tue, Jan 13, 2015 2:39 pm
Subject: Re: [Bf-docboard] getting started on w7?

I live in hope, but....


I have just watched the video,  http://www.blender.org/documentation/ 
given by Francesco Siddi and Cambell Barton. supposedly about 
documentation.


It was about technology to enable documentation, not about 
documentation.


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."


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?"


The presenters responded with more tech because they were giving a 
presentation about technology, not a presentation about documentation.


The reply should have been.....


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.


Or something to that effect.




Another member of the audience stated the obvious - there has to be a 
style guide.






You guys have 'ported' (I would say 'copied') the old wiki into a new 
wiki - but the old wiki wasn't designed to work.


What you have is a technically slick, probably wonderfully engineered 
pigs ear.




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.


The answer is not very tecky. It is social and literary. It requires 
social organization.


The tech part is an extremely easy input system (no downloads, no IRC, 
no archived cryptic stuff).
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,
"Glad to have you on board, here's our style sheet and standard layout, 
send me your first draft whenever you can" 


I live in hope....
 






On 13 January 2015 at 20:29, Greg Zaal &lt;gregzzmail at gmail.com&gt; 
wrote:
Hi Marco,

I've just updated the Windows install instructions here: 
http://blender.org/manual/about/install/windows.html


Let me know if you have any issues following that :)

Cheers,

Greg


On 13 January 2015 at 19:35, marco ardito &lt;ardito at apiform.to.it&gt; 
wrote:
              trying to get manual source on my win7x64sp1 work pc...
    after installing svn, and ckecked out trunk, then
    get python 1.7 with msi installer.... now?

    http://www.blender.org/documentation/get-started page says:

     "Make sure you have Python 2.7 installed and get the virtualenv    
tool: pip install virtualenv"

     well I have Python 2.7 installed now, but where should I type "pip  
  install virtualenv" ?
     at the command line... (ie for me d:\python27) "pip install    
virtualenv" is not working...

    help please...

    --
                  Marco




  -------------------[Ai sensi e per  gli  effetti della Legge sulla 
tutela della privacy(L. 196/2003), questa  mail  è destinata unicamente 
alle persone sopraindicate e le informazioni in essa contenute sono da 
considerarsistrettamente riservate. E' proibito leggere, copiare, usare 
odiffondere il contenuto della presente mail senza autorizzazione.Se 
avete ricevuto questo messaggio per errore, siete pregati dirispedire 
la stessa al mittente. Grazie]

_______________________________________________
Bf-docboard mailing list
Bf-docboard at blender.org
http://lists.blender.org/mailman/listinfo/bf-docboard





_______________________________________________
Bf-docboard mailing list
Bf-docboard at blender.org
http://lists.blender.org/mailman/listinfo/bf-docboard_______________________________________________
Bf-docboard mailing list
Bf-docboard at blender.org
http://lists.blender.org/mailman/listinfo/bf-docboard





More information about the Bf-docboard mailing list