As I just posted in José announces Livebook - a web application for writing interactive and collaborative code notebooks, I think that Livebook could be a great way to generate this sort of reference documentation (e.g., with executable examples).
-r
