- added documentation to the new extracting methods
- refactored tests to reflect examples in documentation