catalyst-cooperative / pudl

The Public Utility Data Liberation Project provides analysis-ready energy system data to climate advocates, researchers, policymakers, and journalists.
https://catalyst.coop/pudl
MIT License
471 stars 108 forks source link

Clean up and fill out docstrings for use by sphinx #316

Closed zaneselvans closed 4 years ago

zaneselvans commented 5 years ago

The draft documentation, written using ReStructured Text, is successfully building on Read The Docs, and all the docstrings conform to the Google Style guide, which can be translated automatically by Sphinx into reST. However, the contents of the doc strings often needs to be fleshed out -- especially the module and sub-package level docstrings, which are often only a single line and give no overview of the module.

A punchlist of all API elements to be distributed:

cmgosnell commented 4 years ago

duplicate of Issue #498