Fernando Perez wrote: > Hey guys, > > sorry for the silence, mostly on travel. I just wanted to mention > that the sphinx machinery seems quite nice, in particular it produces > both high-quality pdf and client-side searchable html. This is great, > because it measn that the entire doc set is automatically searchable > for the users in a convenient manner, even when running offline and > without the need for any special server config (and in a more > civilized fashion than brute-forcing grep searches). > > Also, Sympy (led by Ondrej), ipython, mayavi2 and at least > neuroimaging.scipy.org have all committed to using this system, and we > hope in the future numpy and scipy will follow suit (at least Jarrod > Millman and Stefan van der Walt, who are doing lots of work on those, > are fully on board with the idea). It would be really nice if all > these projects could offer unified, consistent docs to their users, > and having MPL jump along would be great. > How stable is the API? We (Enthought) use endo, a custom tool build on top of docutils, to generate our docs currently. We have talked about changing tools in the past, but the need to extend the tools to understand Traits has held us back. Thanks, Bryce