Re: C++ documentation overhaul
Thank you for taking the lead on this initiative -- I think many will
agree it is long overdue =) Luckily many of our abstractions and APIs
have stabilized enough that it doesn't seem like many parts of the
basic documentation will have to be written and rewritten!
I started reading through this and seems great so far (a typo or two,
but nothing major). I will leave comments comments in your PR up
today. I meant to yesterday but got distracted with some other things
On Wed, Dec 12, 2018 at 8:13 AM Antoine Pitrou <antoine@xxxxxxxxxx> wrote:
> We are doing a refactor of the C++ documentation which will appear in
> Currently, the main entry point of the C++ documentation is a
> Doxygen-generated API documentation in the traditional format, together
> with a couple MarkDown pages covering some example use cases.
> The rewrite integrates the C++ API documentation in a larger Sphinx
> documentation also holding the format specification and Python docs.
> This allows us to add cross-references very easily and make the whole
> documentation more cohesive.
> To accompany this transformation, I have started writing some prose
> documentation about fundamental concepts in the C++ API. I have
> uploaded a snapshot build of this work-in-progress here:
> Comments and suggestions are welcome.