REWRITING DOCUMENTATION:
- several small fixes