Re: [Boost-docs] interface between library documentation and Boost website

Subject: Re: [Boost-docs] interface between library documentation and Boost website
From: Stefan Seefeld (stefan_at_[hidden])
Date: 2015-07-17 18:22:06

On 17/07/15 02:15 PM, Rene Rivera wrote:
>
>     Comparing the above docs with
>     http://www.boost.org/doc/libs/1_58_0/libs/python/doc/index.html, I
>     notice a couple of differences, suggesting that the process of merging
>     the Boost.Python docs into the Boost.org website isn't quite as
>     straight-forward as dropping in some html files into the appropriate
>     place(s).
>
>
> Which differences are you concerned about? I ask because depending on
> which ones I may have different answers :-)

Well, I'm concerned about the very fact that there are differences,
suggesting the process isn't what it is claimed to be. (Either the html
files are post-processed, or regenerated differently).

The differences I can see (so far) are all minor, and don't really
concern me per se.

So, I'm interested in all answers you may be able to give. :-)

(The tutorial is generated from quickbook, so I can imagine some
slightly different stylesheets to be used in the process, but the
reference manual exists only as raw html, suggesting some tool
manipulates the html directly (yuck !). I'm considering moving the
reference manual to quickbook, too, to simplify the overall process,
before I start editing the content.)

Thanks !

        Stefan

-- 
      ...ich hab' noch einen Koffer in Berlin...