add documentation, add new method
minor changes