[Bf-docboard] getting started on w7?

[Abuelo S. B. Chdancer]

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 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]
>>
>>
>> _______________________________________________
>> 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
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20150113/07f778a6/attachment.htm