I wanted to suggest that documentation for RDF.rb be moved into iRuby notebooks -- i.e., Jupyter notebooks running the Ruby kernel.
Github now supports the rendering of Jupyter notebooks in the browser (see my gist of some notes about Ruby). Some advantages of putting documentation into Jupyter:
- broken code examples could be detected simply by running a notebook from the top.
- users could run
jupyter nbconvert
to convert the documentation into HTML, PDF, or one-cell-at-a-time Powerpoint-like presentations.