jashkenas/docco — Issue #82: Making "docco" pages easier to print and view
Author: RichMorin
Created: 2012-02-27 16:19:12+00:00
State: open

The underscore.coffee page is an interesting example of literate programming:

http://jashkenas.github.com/coffee-script/documentation/docs/underscore.html

However, I had to jump through a number of hoops (eg, trying different browsers, scaling the page, using landscape mode) before I could print it. It would be nice if it were printable in common browsers by default. jashkenas suggests handling this by adding "print" styles to the default CSS.

It would also be nice if there were a way to move the vertical division between the comments and code (eg, by wrapping the comments). However, that might be a bit more difficult.

Finally, I should note that an underlying problem here is that some of the code lines are (IMHO) unreasonably long. It would be trivial to check line lengths and raise a warning. Of course, getting developers to pay attention is another matter :-).