Hello,
My name is Anastasia Cheetham. I'm a developer with and the documentation lead
for the Fluid Project (http://fluidproject.org). We're beginning the process of
restructuring and redesigning the documentation for our Infusion framework.
Part of that process will include migrating to a new platform for the creation
and distribution of documentation, and we're interested in learning about the
experiences of other open source projects, including PHP.
I've had a look at you How To pages for contributing documentation, and I see
that you use DocBook. I'd be interested in hearing your thoughts on DocBook:
- What do you feel are its strengths? What are its weaknesses?
- How easy or hard it is to customize the look and feel of the interface with
DocBook? i.e. style, layout, navigation, etc.
- Do you use any form of auto-generated API documentation? If so, how to you
manage integration with more narrative text such as tutorials, etc?
I thank you very much for your time, and for any thoughts you can share.
--
Anastasia Cheetham Inclusive Design Research Centre
acheet...@ocad.ca Inclusive Design Institute
OCAD University
