implemented all docstrings for sphinx doc and added doc build to Travis CI

[weiwzhang]

have also implemented a LICENSE.txt.
still failing Travis CI tests (package import issues)

[stefanv]

If you rebase this on master, do the tests still fail?

[weiwzhang]

I've merged my forked repo with master but the tests are still failing. Failed tests for missing packages (e.g. nibabel, tables) issues.

[stefanv]

Please coordinate with @alvinzz and @MichaelTamaki

[alvinzz]

If the packages can be installed with pip, you should be able to just add them to the requirements.txt file

[MichaelTamaki]

For multiple lines in a specific keyword "script", try

script:
  - nosetests --exe --with-coverage --cover-package=music_feats
  - sphinx-build -nW -b html -c ./config -d _build/doctrees . _build/html

I'm actually not sure if building sphinx docs this way would work however...

[MichaelTamaki]

I'm not sure if it's possible to auto-generate docs via Travis-CI, I looked online for some solutions...
https://github.com/Syntaf/travis-sphinx

And maybe look at Cesium's implementation?
https://github.com/cesium-ml/cesium

[weiwzhang]

thanks guys for the suggestions! I've fixed the import (seems like there were only 3 packages that weren't included yet in the requirements.txt). Now the issue is pip can't update the latest version of pretty_midi package (that accommodates both py2 and py3), because it has an outdated midi package. I'm looking for ways around that.

[stefanv]

numpydoc should be added to the .travis.yml but not the requirements.txt---it is not a music-features requirement directly.

[weiwzhang]

Yeah I fixed that! @stefanv do you mind checking the current error message? It seems like the sphinx/environment.py can't find "/home/travis/build/weiwzhang/music-features/_build/doctrees/index.doctree". But I tried locally and I do have index.doctree in my _build/doctrees folder...thanks!!

(Build#27: https://travis-ci.org/weiwzhang/music-features/builds/184866101)