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

Reply via email to