[Bf-committers] Documentation editing is not user friendly

Campbell Barton ideasman42 at gmail.com
Fri Jan 29 00:06:11 CET 2016

On Thu, Jan 28, 2016 at 9:04 PM, Knapp <magick.crow at gmail.com> wrote:
> The cost of entry IMOHO is way to high. With Wikipedia I don't even have to
> be logged in to edit. They do semi protect and protect some areas of
> Wikipedia meaning you do have to log in or have right but most of it is
> open. I have on many occasion thought I would like to fix something in
> Blender's manual but there was no way I was going through all that just to
> fix one mistake. I am sure I am not alone in this.
> BTW I want to clearly state that Aaron Carlisle (sorry I forgot your name
> before) was and is a great help but I should not need him to do this. I
> should not need to install software to do simple edits or learn a new
> markup language, even if it is easy.

We don't expect people to setup docs building locally, for single edits/fixes.
In that case you can report a bug in the docs (include the fix if it helps).

> So no point beating a dead house. I think it needs to change. We are
> certainly losing a lot of help by it being so complicated to chip in.

For sure there are pro's and cons, but you're re-raising a topic we
already went over at length.

> I read over the other conversation and found this quote. I think it sums up
> the problem, as I see it, very well.
> "koil:
> I've reviewed the ideas posted on this topic, and given the matter a
> good deal of thought. My reaction is mixed. In theory, I wouldn't have
> any problem with porting the User Manual for Blender to the Sphinx
> platform, (or some other one, if it be deemed reasonable and proper to
> do so). However, since Blender is open source, and community developed,
> I think it that it is imperative that there be mechanism for maintaining
> user development of the documentation, too. And, unless I totally
> misunderstand the new platform (and that's not an outlandish
> possibility), moving the whole manual to the proposed new platform is
> going to reduce the contributions to the documentation by members of the
> community by a couple of orders of magnitude, and unless there is a
> sizeable cohort of documentation waiting in the wings, I'm loathe to
> disenfranchise a significant number of contributors to the documentation."
> It has been almost a year since the change, I think. How has the rate
> of editing changed? It the quality better? Is it going better now? Do
> we have any stats?
> Douglas
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at blender.org
> http://lists.blender.org/mailman/listinfo/bf-committers

- Campbell

More information about the Bf-committers mailing list