[Bf-committers] Documentation editing is not user friendly

Aaron Carlisle carlisle.aaron00 at gmail.com
Wed Jan 27 22:56:31 CET 2016


I should also mention that you can report bugs on the tracker [1]
This way editors know what specifically is wrong and can more
easily fix it.

1. https://developer.blender.org/maniphest/task/create/?project=53

On Wed, Jan 27, 2016 at 4:48 PM, Aaron Carlisle <carlisle.aaron00 at gmail.com>
wrote:

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


More information about the Bf-committers mailing list