Summary

Add release notes for Djblets 6.0.

Review Request #14759 — Created Jan. 5, 2026 and submitted May 24, 2026, 7:55 p.m.

Information

Owner

chipx86

Repository

Djblets

Branch

release-6.x

Bugs

Depends On

Reviewers

Groups

djblets

People

Description

Djblets 6.0 is a large release, featuring caching improvements, new
dynamic page state injection support, general rate limiting, cache
locks, layered siteconfig lookups, new templatetag support, and a whole
lot more.

This change introduces the release notes for this release, covering
usage information and examples where appropriate.

Given how much is going on in this release, sub-sections have been used
to introduce the major new changes within a module's section, and
examples have been added to help clarify how most of these work. This
will be the pattern going forward, and should also help with any AI bots
that want to learn from our releases.

Testing Done

Built the docs. Checked for bad links, build errors, and any obvious
errors in the text.

Commits

Summary	ID
Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	24c0dce29e31b108b4835c5333352925a74484a4

Summary

Add release notes for Djblets 6.0.

Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.

24c0dce29e31b108b4835c5333352925a74484a4

Issues

Description	From	Last Updated
Typo in description: featureing -> featuring	david	May 4, 2026, 7:41 p.m.
The "featureing" typo in the description was never fixed.	maubin	May 19, 2026, 9:20 p.m.
We don't have anything referencing this.	david	May 4, 2026, 7:42 p.m.
This is a little bit confusing. Can you maybe clarify that once the deprecated modules are removed, this dependency should …	david	May 4, 2026, 7:43 p.m.
Grammar here is a bit weird ("TemplateHook are a powerful way")	david	May 4, 2026, 7:44 p.m.
Let's say "switch to using django-assert-queries directly"	david	May 4, 2026, 7:45 p.m.
Typo: cam -> can	david	May 4, 2026, 7:45 p.m.
This should be in a djblets.util.templatetags section, not djblets.util.decorators	david	May 4, 2026, 7:46 p.m.
Typo: code-block: html+django -> code-block:: html+django (needs 2 colons)	david	May 4, 2026, 7:46 p.m.
This reads a bit weird. The section for this says "dynamic page injections", so how about: "New module for dynamic …	david	May 12, 2026, 1:29 a.m.
locked is a method, not a property. This should either be if lock.locked(): or if lock.acquired: (which both accomplish the …	david	May 12, 2026, 1:30 a.m.
This says typelets.symbols.UNSET but the code is using djblets.util.symbols.UNSET, and those are currently not the same thing.	david	May 12, 2026, 2:02 a.m.
This is mixing up two different APIs. We have override_feature_check, that takes in a single feature ID and state (like …	david	May 12, 2026, 1:34 a.m.
This should also document the new trace_id argument.	david	May 12, 2026, 1:36 a.m.
This should say Djblets 8.	david	May 12, 2026, 1:36 a.m.
Underline is too long here.	david	May 12, 2026, 1:36 a.m.
While this works, it seems like django templates would usually be written with as_type="int" (with quotes)	david	May 12, 2026, 1:39 a.m.
It'd be nice to include this in the example below as well.	maubin	May 19, 2026, 9:24 p.m.
I feel like the examples flow better if we put this point first, and the keyword args point second.	maubin	May 19, 2026, 9:58 p.m.
The argument name in here is obj but then in the body you use author	david	May 19, 2026, 10:24 p.m.
Your get_raw_object_value() method returns a dict with id, but then you're using pk here.	david	May 19, 2026, 10:25 p.m.
Annotation says you return QuerySet but there's no return statement in here.	david	May 19, 2026, 10:25 p.m.
Does this link correctly?	david	May 19, 2026, 10:25 p.m.
This is importing override_feature_checks twice. One was supposed to be override_feature_check.	david	May 19, 2026, 10:26 p.m.
These aren't quite right. The typelets names have Django in them (e.g. SerializableDjangoJSONDict)	david	May 19, 2026, 10:26 p.m.

flake8 passed.

JSHint passed.

The issue has been resolved. Show all issues

Typo in description: featureing -> featuring

docs/releasenotes/5.3.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
We don't have anything referencing this.
```

docs/releasenotes/5.3.rst (Diff revision 1)

The issue has been resolved. Show all issues

This is a little bit confusing. Can you maybe clarify that once the deprecated modules are removed, this dependency should be used directly instead?

docs/releasenotes/5.3.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Grammar here is a bit weird ("TemplateHook are a powerful way")
```
docs/releasenotes/5.3.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Let's say "switch to using django-assert-queries directly"
```
docs/releasenotes/5.3.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Typo: cam -> can
```

docs/releasenotes/5.3.rst (Diff revision 1)

The issue has been resolved. Show all issues

This should be in a djblets.util.templatetags section, not djblets.util.decorators

docs/releasenotes/5.3.rst (Diff revision 1)

The issue has been resolved. Show all issues

Typo: code-block: html+django -> code-block:: html+django (needs 2 colons)

Change Summary:

Rewrote these for Djblets 6, and to provide subsections to break things apart with examples used to illustrate the major changes.

Summary:

Add release notes for Djblets 5.3.

Add release notes for Djblets 6.0.

Description:

~		Djblets 5.3 is a large release, featureing caching improvements, new
	~	Djblets 6.0 is a large release, featureing caching improvements, new
		dynamic page state injection support, general rate limiting, cache
		locks, layered siteconfig lookups, new templatetag support, and a whole
		lot more.

		This change introduces the release notes for this release, covering
		usage information and examples where appropriate.
	+
	+	Given how much is going on in this release, sub-sections have been used
	+	to introduce the major new changes within a module's section, and
	+	examples have been added to help clarify how most of these work. This
	+	will be the pattern going forward, and should also help with any AI bots
	+	that want to learn from our releases.

Commits:

	Summary	ID
	Add release notes for Djblets 5.3. Djblets 5.3 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate.	3fa6f62e2f2abb2333eb49248c69a9e717289b5d
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	f20c1587c1653f21ae2805ec37283251d5fac310

Branch:

release-5.x

release-6.x

Diff:

Revision 2 (+1884)

Show changes

	docs/djblets/coderef/index.rst
	docs/releasenotes/6.0.rst
	docs/releasenotes/conf.py
	docs/releasenotes/index.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

docs/releasenotes/6.0.rst (Diff revision 2)

The issue has been resolved. Show all issues

This reads a bit weird. The section for this says "dynamic page injections", so how about: "New module for dynamic page state injection into templates"?

docs/releasenotes/6.0.rst (Diff revision 2)

The issue has been resolved. Show all issues

locked is a method, not a property. This should either be if lock.locked(): or if lock.acquired: (which both accomplish the same thing).

docs/releasenotes/6.0.rst (Diff revision 2)

The issue has been resolved. Show all issues

This says typelets.symbols.UNSET but the code is using djblets.util.symbols.UNSET, and those are currently not the same thing.

chipx86

May 12, 2026, 2:03 a.m.

Going to make that module just forward on to typelets, like we did with djblets.util.typing.

docs/releasenotes/6.0.rst (Diff revision 2)

The issue has been resolved. Show all issues

This is mixing up two different APIs.

We have override_feature_check, that takes in a single feature ID and state (like you have here), or override_feature_checks, which takes in a dict of states for multiple features.

We should include docs for both of those here.

docs/releasenotes/6.0.rst (Diff revision 2)
The issue has been resolved. Show all issues
```
This should also document the new trace_id argument.
```
docs/releasenotes/6.0.rst (Diff revision 2)
The issue has been resolved. Show all issues
```
This should say Djblets 8.
```
docs/releasenotes/6.0.rst (Diff revision 2)
The issue has been resolved. Show all issues
```
Underline is too long here.
```

docs/releasenotes/6.0.rst (Diff revision 2)

The issue has been dropped. Show all issues

While this works, it seems like django templates would usually be written with as_type="int" (with quotes)

chipx86

May 12, 2026, 2:03 a.m.

The Djblets template tags support sets those as strings, directly. If we do as_type="int", we get the string '"int"', which leads to:

django.template.exceptions.TemplateSyntaxError: as_type="int" is not supported

Change Summary:


Added notes on the djblets.util.typing and .symbols transitions.
Added a note on the extension static media installation fixes.
Improved wording about page state injections.
Fixed some code examples.
Reworked the feature check override notes.
Added the trace_id argument.
Fixed deprecation warnings.
Fixed syntax issues.

Commits:

	Summary	ID
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	f20c1587c1653f21ae2805ec37283251d5fac310
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	afc1e3686a2d93cc0a46e273cdb1b1bedd9fb111

Diff:

Revision 3 (+2042)

Show changes

	docs/djblets/coderef/index.rst
	docs/releasenotes/6.0.rst
	docs/releasenotes/conf.py
	docs/releasenotes/index.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

The issue has been resolved. Show all issues

The "featureing" typo in the description was never fixed.

docs/releasenotes/6.0.rst (Diff revision 3)
The issue has been resolved. Show all issues
```
It'd be nice to include this in the example below as well.
```

docs/releasenotes/6.0.rst (Diff revision 3)

The issue has been resolved. Show all issues

I feel like the examples flow better if we put this point first, and the keyword args point second.

Change Summary:


Improved the examples and text for datagrid JSON serialization.
Changed the order of the blocktag examples.
Added a coderef page for djblets.extensions, so a link would resolve.

Description:

~		Djblets 6.0 is a large release, featureing caching improvements, new
	~	Djblets 6.0 is a large release, featuring caching improvements, new
		dynamic page state injection support, general rate limiting, cache
		locks, layered siteconfig lookups, new templatetag support, and a whole
		lot more.

		This change introduces the release notes for this release, covering
		usage information and examples where appropriate.

		Given how much is going on in this release, sub-sections have been used
		to introduce the major new changes within a module's section, and
		examples have been added to help clarify how most of these work. This
		will be the pattern going forward, and should also help with any AI bots
		that want to learn from our releases.

Commits:

	Summary	ID
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	afc1e3686a2d93cc0a46e273cdb1b1bedd9fb111
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	716b723b02d6d10e1b47b08f1b0e320addec3626

Diff:

Revision 4 (+2124)

Show changes

	docs/djblets/coderef/index.rst
	docs/releasenotes/6.0.rst
	docs/releasenotes/conf.py
	docs/releasenotes/index.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

docs/releasenotes/6.0.rst (Diff revision 4)

The issue has been resolved. Show all issues

The argument name in here is obj but then in the body you use author

docs/releasenotes/6.0.rst (Diff revision 4)

The issue has been resolved. Show all issues

Your get_raw_object_value() method returns a dict with id, but then you're using pk here.

docs/releasenotes/6.0.rst (Diff revision 4)

The issue has been resolved. Show all issues

Annotation says you return QuerySet but there's no return statement in here.

docs/releasenotes/6.0.rst (Diff revision 4)
The issue has been dropped. Show all issues
```
Does this link correctly?
```
1. chipx86
  
  May 19, 2026, 10:40 p.m.
  Yeah, beanbag-docutils gives us wrapping of references.

docs/releasenotes/6.0.rst (Diff revision 4)

The issue has been resolved. Show all issues

This is importing override_feature_checks twice. One was supposed to be override_feature_check.

docs/releasenotes/6.0.rst (Diff revision 4)

The issue has been resolved. Show all issues

These aren't quite right. The typelets names have Django in them (e.g. SerializableDjangoJSONDict)

Change Summary:


Fixed a number of code examples noticed by David and then some noticed by Claude.
Fixed some off-by-one indentations in some code blocks that I noticed.

Commits:

	Summary	ID
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	716b723b02d6d10e1b47b08f1b0e320addec3626
	Add release notes for Djblets 6.0. Djblets 6.0 is a large release, featureing caching improvements, new dynamic page state injection support, general rate limiting, cache locks, layered siteconfig lookups, new templatetag support, and a whole lot more. This change introduces the release notes for this release, covering usage information and examples where appropriate. Given how much is going on in this release, sub-sections have been used to introduce the major new changes within a module's section, and examples have been added to help clarify how most of these work. This will be the pattern going forward, and should also help with any AI bots that want to learn from our releases.	24c0dce29e31b108b4835c5333352925a74484a4

Diff:

Revision 5 (+2138)

Show changes

	docs/djblets/coderef/index.rst
	docs/releasenotes/6.0.rst
	docs/releasenotes/conf.py
	docs/releasenotes/index.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

Ship it!

```
Ship It!
```

Status:: Completed
Change Summary:: Pushed to release-6.x (5ce70f9)