Fix editable_slug hook documentation

[DrewAPicture]

In the way that these things sometimes happen, the hook doc for the original use of the editable_slug filter is not lining up in the code reference due to the apply_filters() call being nested within HTML. For the initial instance of the hook, we need to break out the value.

[dd32]

In 31687:

Fix the editable_slug hook documentation, the PHPDoc must come directly before the hook call, with no HTML inbetween.
Props DrewAPicture. Fixes #31569

[DrewAPicture]

In 31688:

Update hook docs for the editable_slug filter as it is evaluated in more than just a term slug context, it is also leveraged for use with post URIs.

See #31569.