fix docstring styles.
better method names.
json api version + pep8.