As we've been using Github for a while now, do you think that files included in the repo should be brought upto modern standards? May as well take full advantage of the tools we already use.
I'm talking about /doc/ and the samples folder.
Github has this marvellous markdown capability and we're pretty much ignoring it. The only place it's used is in Readme.md, and we even have a .txt variant of that for no reason whatsoever.
Updating /doc/ to use Markdown will provide us with the ability to link directly to files/lines within the repo, include snipets, hyperlinks, even example images for users viewing the docs via github itself.
It just seems such a waste to have those monstrous text files gathering dust when we can be using them for so much more.
And before anyone comes up with some cynical ".md extension" rubbish, .md can be read by all text editors too. And via the web. And is still readable in plain-text format for "backwards users compatibility". So no excuse really.