[AstroPy] Best practices for Python sample code in journal articles

[Singer, Leo P. (GSFC-661.0)[UNIVERSITIES SPACE RESEARCH ASSOCIATION]]

Hi,

I am working on an ApJ submission that I would like to pair with a supplement paper that contains (among other things) some Astropy-based sample/tutorial Python code to acquaint the reader with an accompanying data release. Are there any established best practices for including Python in journal articles? Should code and output be presented docstring-style or should it look like an IPython session? Does anyone have nice examples of astronomy papers that include supplemental IPython notebooks?

If anyone is interested, this is the article and data release:
https://arxiv.org/abs/1603.07333
http://asd.gsfc.nasa.gov/Leo.Singer/going-the-distance/

Cheers,
Leo


Dr. Leo P. Singer
NASA Postdoctoral Program Fellow
Goddard Space Flight Center
8800 Greenbelt Rd., B34, Room S239
Greenbelt, MD 20771