Now that the FLTK-1.3.x documentation is being restructured to use
doxygen, would it be worth while to introduce two, or possibly three
new chapters or appendices:

a. Frequently Asked Questions:
   Although the web site has an Articles & FAQs page, the interface
   is a little awkward and it is clear that people don't always search
   there before they ask questions on the forums/lists. [But, by the
   same token, many don't read the rest of the documentation either:-(]
   To avoid the need for continuous update, this section could simply
   show the questions with links to the existing Articles & FAQs pages.

b1.Build environments:
   One paragraph per build environment or IDE outlining what settings
   are required for that environment, where libraries should be located,
   how to handle dynamic/static linking, etc.

b2.Cross compiling: [could be a part of build environments]
   As a minimum, Ian MacArthur's basic guidelines on how to modify the
   makefiles, comment out fluid, etc to build for another platform.

Or are these all subjects that are simply too dynamic for the main
documentation and should therefore only be offered via the web pages
and forums where people can add comments or discuss them in depth?

Are there other subjects that deserve to be covered in more detail in
the main documentation? (e.g. Resizing; Raw image data handling)


D.
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to