Navegando por algumas dicas profissionais sobre coderwall , encontrei esta diretriz muito boa para codificação em Java:
https://github.com/47deg/coding-guidelines/tree/master/java
Eu queria saber como isso era feito, já que a extensão de arquivo “.md” era nova para mim.
Isso me trouxe à descrição do markdown:
http://daringfireball.net/projects/markdown/syntax
Parece um formato muito bom para documentar coisas e se integra bem com o github. Parece uma excelente combinação para mim :).