docs: clarify the use of the where section in configurable rules

[tatomyr]

What/Why/How?

This PR clarifies how to use the where section in configurable rules + minor formatting improvements.

Also, I think we can mention the current behaviour of the narrowing (it stops at the first level) which stems from the original behaviour of the nested visitors. But I haven't figured out yet how to better explain that (and if it's a proper behaviour at all).

Reference

Testing

Screenshots (optional)

Check yourself

• Code changed? - Tested with redoc/reference-docs/workflows (internal)
• All new/updated code is covered with tests
• New package installed? - Tested in different environments (browser/node)

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[changeset-bot]

⚠️ No Changeset found

Latest commit: bc3dc65

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
redocly lint packages/core/src/benchmark/benches/rebilly.yaml	973.5 ± 30.3	940.8	1046.2	1.00 ± 0.04
redocly-next lint packages/core/src/benchmark/benches/rebilly.yaml	970.7 ± 26.0	938.7	1016.3	1.00

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	77.23%	4481/5802
🟡	Branches	67.51%	2468/3656
🟡	Functions	70.86%	744/1050
🟡	Lines	77.44%	4215/5443

Test suite run success

735 tests passing in 102 suites.

Report generated by 🧪jest coverage report action from bc3dc65

[lornajane]

Thanks for adding this