magenta / note-seq

A serializable note sequence representation and utilities.
Apache License 2.0
217 stars 57 forks source link

Add pdoc autogenerated docs #46

Open wtong98 opened 3 years ago

wtong98 commented 3 years ago

Some quick-n-dirty documentation addressing #15

These doc files were generated automatically from existing docstrings using pdoc3. It does a pretty good job of parsing most things, and huge shoutout to the maintainers for keeping crisp, clean docstrings, but it cannot catch everything. In particular, I've omitted everything under note_seq/alignment. These files are not generated automatically, but if you'd like, we can discuss additional infrastructure to do so.

This is certainly not a long-term solution, but a quick fix so users don't have to go digging in source to read the docs. For convenience, I've also tossed the files here, where they can be browsed: https://wlt.coffee/cream/docs/note_seq/

Ideally, we would have a proper readthedocs site, but that would be a much longer, time-consuming project. In the meanwhile, I hope people find this useful!

google-cla[bot] commented 3 years ago

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

:memo: Please visit https://cla.developers.google.com/ to sign.

Once you've signed (or fixed any issues), please reply here with @googlebot I signed it! and we'll verify it.


What to do if you already signed the CLA

Individual signers
Corporate signers

ℹ️ Googlers: Go here for more info.

wtong98 commented 3 years ago

@googlebot I signed it!