Hacker News Reader

Once upon a time these were usually posts on one own blog (self-hosted or not), started with a HOWTO keyword and helped the people just in the same way. Nowadays everything developer must be on GitHub or it won't ever be noticed.

/Old man yells at clouds

View on HN

There's probably something to be said for the easy of editing a markdown file and pushing it to github, versus using some crummy blog platform.

In addition to the fact that folks can submit a PR (or fork) to update the instructions if something goes out of date.

I host my blog using GitHub pages and hugo. Its all still markdown, but it also allows people to go to my vanity url and see stuff formatted exactly as I want it to be.

It is an improvement. Having documentation include with source code means that they can updated together and is less likely to be out of date.

Provided, of course, they don't use the github wiki stuff or use separate repos for documentation.

Reply on news.ycombinator.com