[Bf-docboard] Other projects wiki/sphinx migration

[Ton Roosendaal]

Hi,

The somewhat frustrated (sorry!) response was because of a proposal to close down wiki and move to sphinx for developer docs. I think that would be a big mistake. And most people agree on first trying to upgrade and fix the wiki.

The user manual project has resulted in a fine and good looking manual, but not in a system that invites people to contribute to it. The threshold to get on board is huge. But the current contributors (even when only a few) do handle a lot of work. For that they deserve a lot of appreciation!

It doesn't take away the core issue though. But I am not pushing for an urgent change or solution there. We have far bigger issues to handle the the manual project! :)

-Ton-

--------------------------------------------------------
Ton Roosendaal  -  ton at blender.org   -   www.blender.org
Chairman Blender Foundation - Producer Blender Institute
Entrepotdok 57A  -  1018AD Amsterdam  -  The Netherlands



> On 27 Feb, 2016, at 17:23, Campbell Barton <ideasman42 at gmail.com> wrote:
> 
> On Sat, Feb 27, 2016 at 11:10 PM, Ton Roosendaal <ton at blender.org> wrote:
>> Hi,
>> 
>> It would be a disaster giving up on a system that has the freedom and accessibility wiki has. And even stranger - people who complain about it are not the people who provide tech docs?
>> 
>> The user manual project is worrying me a lot, the sphinx system is so unfriendly that hardly no people will contribute to it. It's really awesome to see that Aaron and Campbell work hard on it, but it's barely a community project.
>> 
>> I rather discuss the future of the manual, and move it back to wiki, than giving up on wiki.
>> 
>> -Ton-
> 
> This is quite a strange response - Its true that we haven't had great adoption.
> 
> On the other hand if you seriously propose to move to a different
> system - we should either do this or not (or let others know its being
> seriously considered - if it really is???).
> 
> For people working on existing manual (and writing translations for
> eg) its really a bad message to give some vague hint that the system
> will be removed and their work will be lost.
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard