Hi,
Hi Johannes,Forwarding to the list; I hope you don't mind.On Mon, Oct 1, 2012 at 3:55 AM, Schönberger Johannes <hannessch...@gmail.com> wrote:
Hi,
great you released 0.7. Lately I changed the font size of the documentation. Although there are some deficiencies with the docs:
1. images in the gallery are too wide: http://scikits-image.org/docs/dev/auto_examples/plot_ polygon.html
Arrgh. Unfortunately, the docs rely on figures being a certain size (or less) in order to fit on the page. That page size was specified relative to the font size (which changed recently). So the image sizes didn't change (as far as I can tell), but the page width shrank.Really, we should just set the stylesheet to cap the image size (as Andreas suggested months ago in some PR).2. homepage size not consistent with the restIndeed. I believe you have a PR to fix this ;) Sorry, it's been ignored for so long.3. the updated API reference lists a lot of duplicates. I think, it is sufficient to list "subpackage.function" and leave out the "subpackage.file.function". My guess is that Sphinx 1.1.X caused this new behavior.
Hmm, I'm not sure what could have changed this. Note that the duplicates appear in `doc/source/api/api.txt`, which is generated by some combination of apigen.py, docscrape.py, docscrape_sphinx.py, and numpydoc.py in `doc/tools/` and `doc/ext/`. My guess is that the problem was caused by a change to one of these files. I'm not sure where exactly.-Tony
Regards,
Johannes Schönberger