Improve cli documentation

The docstring was moved out of scanner docstring spot to work around a bug in our current Python version. See https://bugs.python.org/issue28739

Depends on !74 (closed)

---

Migrated from D4090 (view on Phabricator)