Summary

Add a dedicated docs page for pre-defined URL names.

Review Request #15059 — Created May 15, 2026 and submitted May 19, 2026, 10:26 p.m.

Information

Owner

chipx86

Repository

Review Board

Branch

release-8.x

Bugs

Depends On

Reviewers

Groups

reviewboard

People

Description

We have a few places in the documentation where we document an

apply_to setting. The static media page documents several pre-defined

URL names or lists of names, and other places either link to this or

just ignore that there's a list at all. Another page will soon need

this.
These URL names have been moved into a dedicated page, and extended out

a little bit (but more work would be valuable here). All references to

apply_to now point to this page (with the exception of ActionHook,

which is getting a rewrite that will incorporate it).

Testing Done

Built the docs. Checked the links, and checked for any obvious errors.

Commits

Summary	ID
Add a dedicated docs page for pre-defined URL names. We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).	cfe3f30e505c8c21550b9404a78030642fdc87b0

Summary

Add a dedicated docs page for pre-defined URL names.

We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).

cfe3f30e505c8c21550b9404a78030642fdc87b0

Issues

Description	From	Last Updated
This should probably be "Most URLs have a name that can be referenced", since it's definitely not all. We should …	david	May 18, 2026, 10:34 p.m.
Maybe call out that this does not include 'review-request-detail'?	david	May 18, 2026, 10:35 p.m.

flake8 passed.

JSHint passed.

Change Summary:

Removed a stray + that got added.

Commits:

	Summary	ID
	Add a dedicated docs page for pre-defined URL names. We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).	3a98b086eb53e6e5dbac6a2c02139b1aa09b888b
	Add a dedicated docs page for pre-defined URL names. We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).	9677f29ba76f100a007c9d027bf3a46e8a7a7595

Diff:

Revision 2 (+124 -76)

Show changes

	docs/manual/extending/index.rst
	docs/manual/extending/extensions/js-extensions.rst
	docs/manual/extending/extensions/static-files.rst
	docs/manual/extending/extensions/url-names.rst
	docs/manual/extending/extensions/hooks/template-hook.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

docs/manual/extending/extensions/url-names.rst (Diff revision 2)

The issue has been resolved. Show all issues

This should probably be "Most URLs have a name that can be referenced", since it's definitely not all.

We should probably also mention how these can be used in apply_to lists, which is probably more common than linking.

docs/manual/extending/extensions/url-names.rst (Diff revision 2)
The issue has been resolved. Show all issues
```
Maybe call out that this does not include 'review-request-detail'?
```

Change Summary:


Wrote some copy about how URL names are most used, with links to local_site_reverse, {% url %}, and apply_to lists.
Added an entry for all_review_request_url_names.

Commits:

	Summary	ID
	Add a dedicated docs page for pre-defined URL names. We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).	9677f29ba76f100a007c9d027bf3a46e8a7a7595
	Add a dedicated docs page for pre-defined URL names. We have a few places in the documentation where we document an `apply_to` setting. The static media page documents several pre-defined URL names or lists of names, and other places either link to this or just ignore that there's a list at all. Another page will soon need this. These URL names have been moved into a dedicated page, and extended out a little bit (but more work would be valuable here). All references to `apply_to` now point to this page (with the exception of `ActionHook`, which is getting a rewrite that will incorporate it).	cfe3f30e505c8c21550b9404a78030642fdc87b0

Diff:

Revision 3 (+196 -82)

Show changes

	docs/manual/_ext/rbwebsite_refs.py
	docs/manual/extending/index.rst
	docs/manual/extending/extensions/js-extensions.rst
	docs/manual/extending/extensions/static-files.rst
	docs/manual/extending/extensions/url-names.rst
	docs/manual/extending/extensions/hooks/template-hook.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

Status:: Completed
Change Summary:: Pushed to release-8.x (e353a1d)