This blog post (from Parse.com, recently mentioned on the list) has an excellent discussion of good practices for writing API documentation: http://blog.parse.com/2012/01/11/designing-great-api-docs/
Fortunately, we follow a lot of these already, but more improvement is always possible. -- sam th sa...@ccs.neu.edu _________________________ Racket Developers list: http://lists.racket-lang.org/dev