[Bf-docboard] Propsal: fundamentals, citation

[Campbell Barton]

Am quite against replacing the glossary,
in computer graphics their are many cryptic terms (FSAA, SSS, gimbal
lock, ngon... etc),

As an author you can write :term:`FSAA` which links to the glossary,
if the term is missing, you get a warning and you can add it.
The descriptions generally short and to the point, with links to
expanded information where appropriate.
There is also no need to manage page hierarchy, add new categories,
think about where each term *belongs*.
its a big list which is easy to search and linked to as needed.

What you suggest is a more general document on computer graphics
fundamentals which is OK,
but outside the scope of a software manual.

>From reading what you have so far, its quite esoteric from a user
perspective and more of interest to developers, with links links to
technical papers on each topic.
People interested in such papers can find it themselves searching
online and don't need us to spend time on a document for this, which
is likely to be outdated in a few years anyway.

eg:

http://blender-manual.readthedocs.io/en/testing/fundamentals/physics/phy_matter.html
http://blender-manual.readthedocs.io/en/testing/fundamentals/computer/com_light.html

Or, if there is some need for a document like this, I think its
different enough from a software reference manual,
that it can be maintained as a separately (which the manual could link
to, when it makes sense, as with any other web site).

On Wed, Jun 15, 2016 at 5:57 AM, Tobias Heinke
<heinke.tobias at t-online.de> wrote:
> Hi Campbell,
>
> Yes, to replace the glossary.
> First I want to keep the glossary parallel to Fundamentals and then
> dissolve it into Funda term by term.
>
> Tobias
>
>
> Am 14.06.2016 um 19:23 schrieb Campbell Barton:
>> Hi Tobias,
>> are you proposing
>> http://blender-manual.readthedocs.io/en/testing/fundamentals/index.html
>> be moved to https://www.blender.org/manual/
>> and maintained in our subversion repository along with the rest of the manual?
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> https://lists.blender.org/mailman/listinfo/bf-docboard



-- 
- Campbell