[Bf-docboard] getting started on w7?

[Campbell Barton]

On Wed, Jan 14, 2015 at 9:38 AM, Abuelo S. B. Chdancer
<playadance at gmail.com> wrote:
> 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....

It seems you sum up the situation quite well, as a first step we moved
to a new technology with old (problematic) content,
Francesco and myself are not are more technically focused (not so much writers),

The reason we didnt hand out an email address is that nobody has that
position (as far as I know).
If a project is community run, you need people in the community to
fill positions - that includes helping others get involved.

> 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
>>
>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>



-- 
- Campbell