[Bf-docboard] New (Sub)Sections in the Blender Documentation Wiki

[Stefano Selleri]

Well, let put it this way

Docbook was inherently structured, so splitting was easily handeled

Mediawiki is inherently unstructured, so splitting must be handled veery
carefully!

THe 'global table of contents' is not something automatic but maintained by
hand, so we must not let it 'explode'

The 'Light' part can be divided in more chapter, but each chapter must
remain a single wiki page otherwise consistency will be lost very easily.

Stefano

----- Original Message ----- 
From: "Olivier SARAJA (Linuxgraphic)" <olivier.saraja at linuxgraphic.org>
To: "Blender Documentation Project" <bf-docboard at projects.blender.org>
Sent: Thursday, November 03, 2005 8:09 AM
Subject: Re: [Bf-docboard] New (Sub)Sections in the Blender Documentation
Wiki


Le Jeudi 3 Novembre 2005 00:03, Tobias Regenbrecht a écrit :
> Some Pages (will) get extremely long, e.g.
> http://mediawiki.blender.org/index.php/Manual/PartV/Lamp_Types
>
> Would it make sense to split pages up, or do you want to keep the pages in
> one?

your remark makes sense to me. In the POV-ray documentation, for example,
everything is clearly split in sections, sub-sections, sub-sub-sections.
It's
perfect for an HTML or an online use. But one of the purposes of this board
is producing/maintaining a paper blender guide, and splitting things this
way
could break the general layout of the book. I really don't know what should
be done, but from my point of view, short chapters / long chapters is fine
within a book, and an annoyance on a screen.

Not sure I was helpful there :D

-- 
Olivier SARAJA

_______________________________________________
Bf-docboard mailing list
Bf-docboard at projects.blender.org
http://projects.blender.org/mailman/listinfo/bf-docboard