LUMIERA.clone/doc/index.txt
Ichthyostega 6822a9e2fb DOC: reorganise the Doxygen configuration and structure
- upgrade the configuration to a current version
- provide a frontpage with cross-links to other documentation
- define a set of modules; relevant classes and files can be
  added to these, to create a exploration path for new readers
- fix a lot of errors in documentation comments
- use a custom configuration for the documentation pages
- tweak the navigation, the sections and further arrangements
2013-10-25 06:34:38 +02:00

49 lines
1.7 KiB
Text

Documentation
=============
// Menu : append child 'doxy'
This documentation section contains documentation for both users and developers.
== User ==
As a start, you should visit the introductory text
link:user/intro/intro.html[Lumiera (as seen) from Outer Space]
A user manual containing the full reference for using Lumiera is planned:
* link:user/manual.html[User Manual] _(planned)_
== Developer ==
Information about the structure and concepts Lumiera is based upon.
These documents give an overview on the main components of the application:
* link:design/index.html[Design Documents]
Programming-oriented details about the functional layers of Lumiera as well as a Doxygen documentation :
* link:technical/index.html[Technical Documents]
* link:technical/code/codingGuidelines.html[Style and Coding Guidelines]
=== the TiddlyWiki ===
Currently, Lumiera is still in the design- and evolution phase.
There is an embedded JavaScript wiki (TiddlyWiki) within the source tree, mostly
used as design notebook, featuring day-to-day design sketches, notes but also
quite some more persistent planning. Finished documentation text is constantly
moved over to the documentation section(s) of the Lumiera website.
-> access the Proc-Layer link:http://lumiera.org/wiki/renderengine.html[TiddlyWiki online here]
=== API Documentation ===
We use the link:http://www.doxygen.org/index.html[Doxygen] tool to extract
code comments and generate code level API and reference documentation.
-> link:http://lumiera.org/doxy/index.html[Doxygen generated documentation]
== Media and Presentations ==
This section holds documents and materials used to present and promote Lumiera,
articles, summaries and whitepapers
-> link:/media/index.html[Index]