Re: [PATCH] doc: set up for autoapi / readthedocs compatibility

2020-07-15 Thread David Bremner
Floris Bruynooghe writes: > > I didn't actually try out how much better autodoc does, I should > probably try that too before commenting further. Thanks to both of you for feedback. I've applied the first two to master. It seems tricky to have autodoc on readthedocs without having notmuch2 in

Re: [PATCH] doc: set up for autoapi / readthedocs compatibility

2020-07-14 Thread Floris Bruynooghe
On Sun 12 Jul 2020 at 09:02 -0300, David Bremner wrote: > sphinx-autoapi seems nicer conceptually (it parses the docs rather > than importing them), TIL about sphinx-autoapi, agree it's nicer conceptually. > but it also generates a ton of warnings, so > leave the default as autodoc. > --- > >

[PATCH] doc: set up for autoapi / readthedocs compatibility

2020-07-12 Thread David Bremner
sphinx-autoapi seems nicer conceptually (it parses the docs rather than importing them), but it also generates a ton of warnings, so leave the default as autodoc. --- You can see the results of this (for now) at https://notmuch.readthedocs.io/en/rtdtest/ We'd presumable want to integrate the