Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Search - "admonition"
-
Famous quote time! I forget who said it, and the number varies a bit from one retelling to the next, but one that has always stuck in my mind since I heard it is the following:
“I’d fire any programmer who spends more than [10 | 25]% of his time coding.”
I’ve always taken this as an admonition to spend time charting out solutions before building, instead of churning out stream of consciousness spaghetti code, personally.
Any thoughts from the broader community on the topic?2 -
Markdown admonitions are unofficial extra's to the spec to render basic info/warning/note alert boxes. There were already 2 syntaxes for these:
Supported in python-markdown, Mkdocs, marked js extension: 3 exclamation marks followed by a type, and indenting its contents by 4 spaces:
!!! note
Supported by Docusaurus & extended by Nuxt.js as "MDC" or "markdown components": 3 or more colons followed by a type, and with an end delimiter:
:::note
:::
So why the fuck did Github have to go for this retarded syntax mixing blockquotes with half the syntax of an image link instead of following in the footsteps of others?
> [!NOTE]
>