News for hackers. Stuff that matters.
Re:How to Write a Great Readme by coobird on Tuesday July 18, 2023 @11:36AM (#36774196)
My thought as well.

If every project started to make their README filled with HTML (gah, why does Markdown allow arbitrary HTML...), I'd end up crying on the CLI as I frantically search for how to build the project in a sea of <p>, <a> and <br/>s...

Re:How to Write a Great Readme by avgcorrection on Tuesday July 18, 2023 @11:41AM (#36774299)
> gah, why does Markdown allow arbitrary HTML...

MarkDown is a misleading name.

Re:How to Write a Great Readme by atoav on Tuesday July 18, 2023 @11:55AM (#36774500)
Quite frankly I was happy with the arbitrary html part more often than it annoyed me. E.g. when I had to add a table that was just slightly out of markdowns comfort zone (merged cells).

Those who read my readmes were always happy with the content and never complaines about the html.