added documentation for all newly introduced methods