Once we have a skeleton for a package, with a setup.py file, then we can switch to setting the version number to ``astropy._version_``. * I think we should keep the version number at ``0.0.0`` until we actually start with the coding. I need to look at this in more detail, but a few comments on the minor points: * Customize the docs - I think the default color scheme of sphinx is a bit ugly. * Fix the warnings that numpydoc issues when actual code is built * Customize the gitwash pages once we've finalized our workflow for external packages. * Get the version number from the package into conf.py (I know how to do this, but it requires a definite versioning scheme for the main package). * Determine exactly how we plan to use autosummary such to build docs once we have code to test it on. this is definitely not permanent, as it isn't very pretty, but think of it as a placeholder.Ī few items that still need to be done for the docs (but are perhaps easier done later): Note that it *includes* the modifications to the coding guidelines from note I made a little logo with GIMP. This branch has a basic layout for documentation - mostly the standard sphinx stuff, but with numpydoc and gitwash pulled in, along with our development documents.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |