[Bf-docboard] What about a chapter for "3D Concepts & Fundamentals"

[Felix Rabe]

Bart Veldhuizen wrote:
> On Thu, 2003-01-02 at 19:40, Felix Rabe wrote:

>>I hope my idea is a bit more clear now.  More comments?  Ideas how to 
>>implement it?

> What about inserting a note to ourselves? ('Note: great sources for
> inspiration here: http://acme.com')

Yes - or a list of references: (example for a imaginary chapter on 
Blender licensing with (some) imaginary addresses)

References
^^^^^^^^^^
   o http://www.blender.org/license.html
   o http://www.gnu.org/philosophy/free-sw.html
   o http://www.opensource.org/
   o http://www.creativecommons.org/
   o http://www.microsoft.com/licenses/eula.html
   o http://www.opencontent.org/ocl.html
   o ...

To avoid slowing down the progress of actually writing the chapter, it 
would perhapbs be the best solution to leave that list in plain text (or 
implement some kind of preprocessor (e.g., refpp.py), that parses the 
XML sources for such reference sections, and formats it nicely with 
clickable links (<ulink ...>) and everything).

We just need a template (or a definitive tag to wrap the reference list 
in, such as one of <literallayout>, <screen> or <programlisting>).  It 
would be preferable to have it be automatically processable, so we could 
(e.g.) extract a summary website from it containing the references used 
so far, so that later doc. writers can draw upon that list and see 
whether something could be used a second time for another chapter (or 
the same chapter, if the resource should have changed in the meantime).

I better do not make exact suggestions myself, unless you want something 
horribly complicated.  :o)

cu,
Felix