4 ms·
> Yes, it's more convenient than writing your README in docx or txt, but if you want to do anything with it off the narrow beaten path, you'll inevitably have
by lelandbatey 5y ago
> Yes, it's more convenient than writing your README in docx or txt, but if you want to do anything with it off the narrow beaten path, you'll inevitably have to extend it or give up.
This is true for everything that people actually use. What you just quoted, a "<dl>" tag, is a writing concept that I, and I think most people, have never heard of and have never used in written documents. Maybe that should change, but that's kinda how it is...
- toastal 5y agoAsciiDoc supports definition lists out of the box and I use it all of the time. Instead we see authors using headings above list which is technically incorrect, block quotes for admonitions, and many other poor uses of markup. The same community of devs that laughs at WYSIWYG editors and using bold tags and breaks instead of headings and paragraphs are abusing markdown; like pressing a B for bold, they look at what tools Markdown gives them visually paying no mind to the output markup.