Add documentation about scopes and a note about filters

[ci skip]

Also fix some formatting issues.
Merge pull request #2948 from shekibobo/docs/add-filter-and-scope-docs

Add documentation about scopes and a note about filters