-
The level of the first heading is taken as `` so that
```markdown
### Heading 3
## Heading 2
#### Heading 4
```
produces (with `myst_suppress_warnings: ['myst.header']`)
```html
Headi…
-
This may be out of scope but I'd love to see this tool to be able to automatic fix issues, this makes for many users the difference between ignoring issues and actually fixing them. I guess most issue…
-
I use google style as docstring.
But it doesn't look good when generating doc by portray.
Do I need to follow the same way on portray's doc?
Or can I generate better doc with google docstring sty…
-
I come from a Python background, where I've grown to love [Sphinx](http://www.sphinx-doc.org/en/1.5.1/) and its associated primary markup format, [reStructuredText](http://docutils.sourceforge.net/rst…
-
Raw, almost unedited notes from our unconference session on Sphinx. Suggestion by @plaindocs - what do you think would be the best place to put these?
- what do you love about sphinx
- code int…
-
There is a patch at sourceforge implementing `@diagnostics` fields.
https://sourceforge.net/support/tracker.php?aid=1887564
> This patch adds a new field, called `@diagnostics`, which is treated lik…
-
_From [battm...@gmail.com](https://code.google.com/u/110838061384746797372/) on 2014-11-12T12:55:14Z_
Not sure if this has been mentioned before. I prefer google style code commenting and was wonder…
-
Related to https://github.com/vscode-restructuredtext/snooty-parser/issues/24 and https://github.com/networkx/networkx/issues/4857
![image](https://user-images.githubusercontent.com/1829149/12024…
-
# Feature or enhancement
### Proposal:
While core python uses reStructuredText, many packages maintain their documentation in markdown.
IDEs such as vscode show docstrings in popups when using a fu…
-
I'm packaging your module as an rpm package so I'm using the typical PEP517 based build, install and test cycle used on building packages from non-root account.
- `python3 -sBm build -w --no-isolatio…