Add documentation about scopes and a note about filters

[ci skip]

Also fix some formatting issues.