<div dir="ltr"><div>Hello,</div><div><br></div><div>I've made some updates to the documentation organization.</div><div><br></div><div><a href="https://bigbang-py.readthedocs.io/en/latest/index.html">https://bigbang-py.readthedocs.io/en/latest/index.html</a></div><div><br></div><div>Happy to get any feedback.</div><div><br></div><div>- S<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Oct 8, 2021 at 4:11 PM Sebastian Benthall <<a href="mailto:sbenthall@gmail.com">sbenthall@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hello,<br><div><br></div><div>New documentation us up on RTD, including autodocs for the code docstrings and the README, imported.</div><div><br></div><div><a href="https://bigbang-py.readthedocs.io/en/latest/" target="_blank">https://bigbang-py.readthedocs.io/en/latest/</a><br></div><div><br></div><div>Now that we have a location to put more expansive/complete documentation, we can have dedicated pages for issues, such as the <a href="https://github.com/datactive/bigbang/issues/414" target="_blank">data ingress/egress</a> we support.</div><div><br></div><div>Currently, all of our documentation is in the README, which has gotten quite long.</div><div><br></div><div>We have some options:</div><div> - (a) move material out of the README into dedicated pages that are rendered to the docs, keeping the README light, with "must have" information and links to the docs for other topics.</div><div> - (b) maintain information redundantly in the README and in Sphinx</div><div> - (c) Status quo: keep using the README for almost everything except autodocs.</div><div><br></div><div>My preference is for option (a).</div><div><br></div><div>I wonder how you all feel about the best way to organize the docs.</div><div><br></div><div>- S</div></div>
</blockquote></div>