DOC: fix several Sphinx warnings when building the docs

patch developed with Dmitrijs Milajevs and Ioannis Tziakos
Merge pull request #4219 from ev-br/sphinx_warns

DOC: silence several Sphinx warnings when building the docs