Build Documentation In, Don’t Bolt It On It’s easy to produce good-looking documentation from the comments in source code, and we recommend adding comments to modules and exported functions to give other developers a leg up when they come to use it.
How can we make documentation and literate programming feel more natural?