Re: Sphinx integration
Dave Abrahams <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
on Fri Oct 07 2011, Mateusz Loskot <mateusz-AT-loskot.net> wrote: > On 07/10/11 21:04, Dave Abrahams wrote: >> on Fri Oct 07 2011, Mateusz Loskot <mateusz-AT-loskot.net> wrote: > >>> Looking at slides 30-37, I'm wondering...why Boost documentation >>> looks and feels more like a scientific paper than a handbook. >>> The handbooks are for mortals. The scientific paper are not. >>> The Boost is developed by immortals, so let them use scientific paper. >>> The Boost is for use mostly by mortals who need handbook, but not >>> scientific paper, about Boost. >>> >>> If Boost documentation (and website) aims the slides 30-37, it will be >>> a rockstar documentation. >>> >>> Is it possible at all? >> >> Yes, it's possible. Are you familiar with >> https://svn.boost.org/trac/boost/wiki/ImprovingBoostDocs#Objectives? >> That could be revived. Matias Capeletto was the driving force, IIRC. > > I found it long time ago, forgot and haven't come back since. > > The objectives are aligned to what we've discussed so far. > The idea is feels big. I think it would improve a lot if > we could implement the unification for use and processing > of Doxygen in Boost. Sorry, I don't know what you mean by "implement the unification for use and processing of Doxygen in Boost." Could you explain? > BTW, DocBook seems mandatory > https://svn.boost.org/trac/boost/wiki/DocsOrganization#DocsfilesOrganization Yeah, that was Matias' proposal, but nothing's set in stone of course. -- Dave Abrahams BoostPro Computing http://www.boostpro.com