Added a lot of comments on public methods

Work in progress.