Add documentation about scopes and a note about filters

Also fix some formatting issues.

[ci skip]