Some parts of the documentation need corrections

[raquelalegre]

Remis has identified a few things in the documentation he'd like to change, for example the terminology on Occupancies.

@remislp do you need help from us to do this?

[raquelalegre]

Remis also wants to do some refactoring in methods names. He said he'll list them here for us to change.