Open berndschatz opened 1 year ago
Notes used to render with a little blue "info" icon, and warnings with a little yellow "warning" icon... but not anymore.
Maybe this broke it? https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/
This is markdown (that is designed for small blog entries), we use/need RestructuredText (that is designed for technical documentation).
Hold your horses, I’m with you haha. In this community discussion, they describe that they broke the rendering for the old markdown way of doing admonitions.
What I’m implying (but could have been clear about) is that maybe they still make rST render to whatever intermediate representation the old Markdown syntax rendered to and that way broke it?
Or maybe they never supported it, I don’t remember. Since they do support admonition rendering in Markdown, they should make rST and Asciidoc admonitions render the same way.
Don't know what they do, the docutils works fine, so i assume they have some own stuff: post/pre-processor before / after using the docutils !? Or do they implement a complete own ResT parser !?
PS: Regarding automated testing, there are probably still a few areas for improvement for ResT (and markdown):
Stale issue message
text of warning / note directives should be rendered in a box or/and in another color.
Currently it looks like this:
but it should look somehow like here -->
see also --> https://sublime-and-sphinx-guide.readthedocs.io/en/latest/notes_warnings.html
IMHO this would be a big improvement for the readability of technical documentation with less effort for you for the implementation.