[Bf-docboard] getting started on w7?

Campbell Barton ideasman42 at gmail.com
Wed Jan 14 00:02:21 CET 2015


On Wed, Jan 14, 2015 at 9:49 AM, Fluff Rabbit <fluffrabbit at aol.com> wrote:
> ... 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,

While this is subjective, we have had contributions submitted via our
project page:

https://developer.blender.org/tag/documentation/

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

Nor to me, contributers can get commit access, though to begin with
they can post changes as via our project site.

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



-- 
- Campbell


More information about the Bf-docboard mailing list