HNHacker News
TopNewBestAskShowJobs

skia

1 karma · joined April 10, 2014

submissionscomments
skia··on Ask HN: Why did literate programming not catch on?
A wiki is a terrible instrument for writing software documentation. For example, there is no revision control to track changes as required by by changes in the code, there is much duplication. I could go on, and on, why a wiki is not optimal for any documentation associated to a software project.

Better to use a system like DITA or dockbook.

skia··on Google C++ style guide
Some coding style guides amount to an obsessive compulsive disorder. They focus on trivialities, like an extra space between parameters or the placement of braces around blocks of code.