fixed the warnings
doc full review
Merge pull request #191 from spiral-project/docfix

Minor documentation edits