minor fixes; added some usage info on docstrings
added deprecation warning
removed TIDS from documentation, this should not be used by end users, nor should end users know of the TIDS object.