[WIP] Documentation improvements

[luizirber]

• Is it mergeable?
• make test Did it pass the tests?
• make coverage Is the new code covered?
• Did it change the command-line interface? Only additions are allowed
  without a major version increment. Changing file formats also requires a
  major version number increment.
• Was a spellchecker run on the source code and documentation after
  changes were made?

[codecov-io]

Codecov Report

Merging #362 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #362   +/-   ##
=======================================
  Coverage   87.27%   87.27%           
=======================================
  Files          15       15           
  Lines        2326     2326           
  Branches       36       36           
=======================================
  Hits         2030     2030           
  Misses        295      295           
  Partials        1        1

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1674706...ed02147. Read the comment docs.

[ctb]

Merged into #393.