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

Reply via email to