On May 4, 2013, at 4:03 PM, Igor Galić <iga...@apache.org> wrote: > > Hi folks, > > as those of you follow the commits@ list close may have noticed > we have pushed a branch called sphinx-docs to our git repository. > > The contents of which are the full trunk documentation of the admin > Guide and the SDK docs. Our intent is to move the documentation > into the source tree so we have it in *one* place, making it easier > for developers to update the documentation at the same time. > > It would also mean to move away from ASF CMS system which already > took such pains to implement. There are numerous reasons for this. > The most prevalent is that we no longer wish to write and maintain > our own code to do things that existing documentation systems do > much better. > > Sphinx is such a system, and even though the current state of the > docs is incomplete, after installing you can issue a simple > > make html
I took it for a quick spin and the output was quite promising. +1 > > or, for Leif, a make epub ;) and you will build the complete > documentation tree in a nice looking, publishable format. > > We'll need to take some steps to get there, so if you think that > we're going in a bad direction I encourage you to speak up *now*! > > I also encourage you to provide patches or other forms of help, > if you think that what we're doing is good or worthwhile (: > > > Thank you, > > Igor for the Apache Traffic Server Team
