Expanded documentation: occupancy and general overview

Cecilia Nievasrequested to merge
docs/improve into master

\approve @marius

Edited by Cecilia Nievas

Merge request reports