Ross Barnowski
Ross Barnowski
> I think one of the reasons for that is that the [numpydoc style guide](https://numpydoc.readthedocs.io/en/latest/format.html) is not a comprehensive collection of all the rules in convention that are actually in...
I'd be happy to review things - @Carreau 's insight would also be very relevant here as I know he has been running into (and fixing) corner cases in many...
> but if that were to become part of numpydoc The thing is, it is already recommended by `numpydoc` and has generally been adopted by numpy, scipy, etc. so is...
> One thing I would like to change is the convention that the [short summary](https://numpydoc.readthedocs.io/en/latest/format.html#short-summary) end in a period Agreed. AFAICT this isn't recommended in the style guide, but there...
@anntzer Are you still having this issue? I tried your example and I think the problem is the forward slash on `/index`. If you remove the `/` all build errors...
In that case, the issue appears to be with `_line_rgx` failing to match when a forward slash is present. ```python > /home/ross/.virtualenvs/numpydoc/lib/python3.7/site-packages/numpydoc-1.0.0.dev0-py3.7.egg/numpydoc/docscrape.py(303)_parse_see_also() -> description = None (Pdb) l 298 if...
According to the comments in lines 239-253 of `docscrape.py` and the [numpydocs documentation](https://numpydoc.readthedocs.io/en/latest/format.html#sections), it seems that the `see also` section is only intended for references to other functions (or methods,...
That's a good point - it seems that `see also` is the only direct naming collision between the supported sphinx directives and the numpydocs sections. Maybe @jnothman and other maintainers...
af82e8e includes some very rudimentary instructions on creating the thumbnail with sphinx-panels. I only added it to the `contributing.md` so it's not in the readme, but I'd like to deduplicate...
One drawback of `glue` is that it [does not currently support alt-text](https://github.com/executablebooks/MyST-NB/issues/211), which means some of the thumbnails on the front page wouldn't have alt-text. I'm not sure whether that's...