Fix: documentation refs in the_shinken_architecture.rst and related

Cleaned up some lists, fixed some broken references and made ref links where needed.