that actually had the seeds of a really good blog post in there - "you may not know about this, but there's a really cool tool called mermaid that can help you

that actually had the seeds of a really good blog post in there - "you may not know about this, but there's a really cool tool called mermaid that can help you embed diagrams in your markdown files. if you don't see why that's so cool, here are some examples of readme.md files where a mermaid diagram really adds a lot of value". instead it decided to take a turn into a mermaid tutorial, which (a) already exists and (b) if the author wanted to write a better one this was not the venue or format for it. but really it was a failure of execution; the "here is something you might not have even realised was possible or desirable" bit is genuinely valuable.