[Bf-committers] Documentation editing is not user friendly

[Aaron Carlisle]

Hello again Knapp,

I am sorry that you where never able to get that working on your end.
In the future I would try talking to Campbell Barton about such issues
along with other issues on the #blenderwiki on IRC using freenode.net [1]
You can also use the documentation mailing list [2]

As for the your opinion on the wiki Vs. the manual these are all know issues
add are addressed in the manual. [3] One of the reasons the Manual is in
such disrepair is it was a copy of the old wiki, and due to the Cons of that
It also grew out of repair and outdated.

More information can also be founded on the bug tracker. [4]


1.
https://www.blender.org/manual/getting_started/about_blender/community.html#irc-channels
2. http://lists.blender.org/mailman/listinfo/bf-docboard
3. https://www.blender.org/manual/about/migration.html
4. https://developer.blender.org/project/profile/53/

On Wed, Jan 27, 2016 at 3:48 PM, Knapp <magick.crow at gmail.com> wrote:

> I have been working on making a video about the VSE. I thought it would be
> easy but it turns out not to be because of a lot of factors including my
> computer.
>
> To get to the point, the VSE documentation is quite bad. I know it is being
> worked on by someone and I thought I would help him since I was rereading
> everything anyway. But it turned out to be very hard to do.
>
> I thought it would be like Wikipedia, you edit it and it is done. That is
> NOT the way it is. You must first be signed up. You must download a copy of
> the source document code and then you must change that in a funny editors
> language and then you must compile it on your computer. Then you have to
> submit it as if were were writing C code.
>
> Guess what? I could not get it to compile on Sabayon Linux. I don't have
> time to fight with it but I did ask and got a nice reply that he would just
> take my ideas and do it for me. All (not the nice guy) this results in me
> being VERY put off from helping with the documentation. I am sure I am not
> the first to run into this big wall.
>
> I am good with computers but this was WAY too much for me to go through.
> Think what it must be like for the computer phobic artists? It is just
> simply to hard for the average person to bother with. It is no wonder that
> the documentation is so bad. We need to do something to make this light an
> easy.
>
> Ton said that we need someone to interface between the users and the
> developers to let them know about new stuff and how it all works. This is
> the job of the manual and if the manual were as great and cool as the 2.4
> manual then I think we would not need someone to do this so badly for us.
> We need to improve the "new" manual a LOT. It needs to be easy to do.
>
> I think it would be a great idea to move to a system like Wikipedia.
>
> Sorry if this is not the right place to post this but I did not find
> another place.
>
> Let's make working on the manual as easy as helping with Wikipedia!
>
> Thanks,
>
> --
> Douglas E Knapp
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at blender.org
> http://lists.blender.org/mailman/listinfo/bf-committers
>