Feature/reviewed documentation

- Still some work to be done, will submit a new PR for that.