mdboom/astropy — comment on commit fdf8557b66ef223654d30886f7cdb8bbe976aa4f
File: docs/conf.py line 20
By eteq:

So that I'm clear, this generates .rst file in the docs directory, rather than inserting it directly into the sphinx build, correct? I'm a little concerned about generating files in this manner because people may get confused (and if we're going to do this, it should be a generically-usable method) - maybe it would be better to instead add this to a docstring somewhere, and then include that docstring in the documentation via autodoc? Although this may also be something to be fixed in a later pul lrequest.