[Bf-docboard] Feedback on Writing Style

[Gaia]

Would it be useful to add a "contribute" link
at a prominent location in the manual ? For example:

http://www.pasteall.org/pic/show.php?id=81986

The "contribute" link could point to a document which
in turn provides some info about:

- the aims of the manual (why it was moved from the wiki)
- how to setup the manual development
- The writers style guide
- where to get help as a manual writer
- ...

So that all is in one place and easily accessible especially
for users who are just stepping in with a fresh mind...

Also would it be useful to update the following page ?

http://www.blender.org/get-involved/documenters/

thanks
Gaia

On 05.01.2015 13:52, Campbell Barton wrote:
> Hi there,
> Recently we've been adding some notes to the 'writing style',
>
> Currently its mainly a list of what *not* to do (based on reading the
> lower quality wiki-manual text).
>
> See:
> https://developer.blender.org/diffusion/BM/browse/master/readme.rst$34
>
> But I'd be interested to get feedback from people on this list who
> have experience technial writing.
>