We would like to be able to keep "developer notes" in the notebooks as they exist in source form, but strip them out in the rendered notebook. This requires a few things:
Agreeing on exactly what constitutes a "developer note". The easiest rule I can see is for cell that begins with Development note/Developer note (case-insensitive?) to be treated such that the whole cell is a developer note.
The build machinery, when run, should remove those cells before (or in the process of) executing. So the generated exec* notebooks should come with them removed. Then the html conversion will use that and come with the developer notes stripped out.
We would like to be able to keep "developer notes" in the notebooks as they exist in source form, but strip them out in the rendered notebook. This requires a few things:
Development note
/Developer note
(case-insensitive?) to be treated such that the whole cell is a developer note.exec*
notebooks should come with them removed. Then the html conversion will use that and come with the developer notes stripped out.exec*
to be downloaded by clicking on a download icon or something e.g. the download buttons from Astropy tutorials like http://learn.astropy.org/rst-tutorials/color-excess.html?highlight=filtertutorials