Review the documentation as-is, and collect further actions

[zport]

First round completed, newly raised issues can be found under epic #60. Another round can be done to determine if anything was missed or still needs to be updated.