[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 <gregzzmail at gmail.com>
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 <ardito at apiform.to.it>
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