Comment about the java document of jdk8 - http://marxsoftware.blogspot.com.au/2014/03/illuminating-javadoc-of-jdk-8.html

Thoughts On Comments - http://blog.codefx.org/techniques/documentation/thoughts-on-comments/

The Art of Crafting Architectural Diagrams - https://www.infoq.com/articles/crafting-architectural-diagrams http://www.infoq.com/cn/articles/crafting-architectural-diagrams