Summary

Update the My Account page documentation and add new settings.

Review Request #15064 — Created May 17, 2026 and submitted May 19, 2026, 4:26 p.m.

Information

Owner

chipx86

Repository

Review Board

Branch

release-8.x

Bugs

Depends On

Reviewers

Groups

reviewboard

People

Description

The My Account page docs were pretty out-of-date, lacking changes made
since Review Board 7. It was also fairly inconsistent on how it
presented available options and descriptions.

This reworks sections of the page to provide more guidance and less
dense text. It also adds the missing settings, including:

The new Ship It! confirmation and spell check settings.
The Appearance page, added in Review Board 7.

Anchors have been added throughout the page to facilitate linking to
sections from other pages and release notes.

Testing Done

Built the docs. Checked for bad links and build issues.

Commits

Summary	ID
Update the My Account page documentation and add new settings. The My Account page docs were pretty out-of-date, lacking changes made since Review Board 7. It was also fairly inconsistent on how it presented available options and descriptions. This reworks sections of the page to provide more guidance and less dense text. It also adds the missing settings, including: * The new Ship It! confirmation and spell check settings. * The Appearance page, added in Review Board 7. Anchors have been added throughout the page to facilitate linking to sections from other pages and release notes.	c2409b5b81272b1ce3be3c29b1cb5b34b85ac4fe

Summary

Update the My Account page documentation and add new settings.

The My Account page docs were pretty out-of-date, lacking changes made since Review Board 7. It was also fairly inconsistent on how it presented available options and descriptions. This reworks sections of the page to provide more guidance and less dense text. It also adds the missing settings, including: * The new Ship It! confirmation and spell check settings. * The Appearance page, added in Review Board 7. Anchors have been added throughout the page to facilitate linking to sections from other pages and release notes.

c2409b5b81272b1ce3be3c29b1cb5b34b85ac4fe

Issues

Description	From	Last Updated
Existing field labels in this file don't have trailing colons. Your newly added ones are a mix--some do, some don't.	david	May 18, 2026, 7:28 p.m.
Don't these different formatl (compact dl vs multi-paragraph list items) render differently? We should probably add a blank line to …	david	May 18, 2026, 7:33 p.m.
The 2nd sentence sounds a bit weird, maybe use "different" instead of "other"? Also theres no trailing period.	maubin	May 18, 2026, 7:26 p.m.
This should probably refer to the fact that this entire page was added in 7.0.	david	May 18, 2026, 7:34 p.m.
I know that this is what the label says, but looking here, I wonder if we should change that to …	david	May 18, 2026, 7:40 p.m.
This page is now much more than just changing password (also includes API tokens, OAuth tokens)	david	May 18, 2026, 7:47 p.m.
This should probably have a _my-account-change-password anchor	david	May 18, 2026, 7:48 p.m.
You're mixing bulleted lists and numbered lists here.	david	May 18, 2026, 7:50 p.m.

flake8 passed.

JSHint passed.

docs/manual/users/settings.rst (Diff revision 1)

The issue has been resolved. Show all issues

The 2nd sentence sounds a bit weird, maybe use "different" instead of "other"? Also theres no trailing period.

chipx86

May 18, 2026, 7:50 p.m.

I think I was trying to decide how I wanted this sentence to go and got distracted.

docs/manual/users/settings.rst (Diff revision 1)

The issue has been resolved. Show all issues

Existing field labels in this file don't have trailing colons. Your newly added ones are a mix--some do, some don't.

docs/manual/users/settings.rst (Diff revision 1)

I believe it should be fine with the intersphinx setup, but just wanted to call out that the old name here is still in the 3.0 release notes.

chipx86

May 18, 2026, 7:50 p.m.

Should be fine, but doesn't hurt to keep the old name around.

docs/manual/users/settings.rst (Diff revision 1)

The issue has been resolved. Show all issues

Don't these different formatl (compact dl vs multi-paragraph list items) render differently? We should probably add a blank line to the existing ones so they all render as paragrphs.

chipx86

May 18, 2026, 7:50 p.m.

Definitely incorrect before. Fixing them.

docs/manual/users/settings.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
This should probably refer to the fact that this entire page was added in 7.0.
```

docs/manual/users/settings.rst (Diff revision 1)

The issue has been dropped. Show all issues

I know that this is what the label says, but looking here, I wonder if we should change that to be "Match system theme"?

chipx86

May 18, 2026, 7:50 p.m.

Probably. It started out being Light Mode by default, which is why it was named that way.

I took a quick stab at it and think it's too late to make a change here for this release. It's not a list of hard-coded items but rather something based on the registry, where it grabs the default, populates the first entry, and then adds remaining entries. This is then all based on siteconfig state and some other logic. Doing it right is more involved than changing a string, and we'd need to figure out whether we'd want to keep the previous UI if the default theme is different. Today that's unlikely, but yeah, lots of work with considerations to make, and best done in a future release.

docs/manual/users/settings.rst (Diff revision 1)

The issue has been resolved. Show all issues

This page is now much more than just changing password (also includes API tokens, OAuth tokens)

docs/manual/users/settings.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
This should probably have a _my-account-change-password anchor
```

docs/manual/users/settings.rst (Diff revision 1)

The issue has been dropped. Show all issues

You're mixing bulleted lists and numbered lists here.

chipx86

May 18, 2026, 7:50 p.m.

Correct. Some are multi-step processes (creating a token, removing a token). Editing is not. Those are different options that can be performed.

Change Summary:


Improved and reworked some wording.
Removed colons from field names.
Converted several definition lists into proper paragraph bullet points.
Added anchors.
Moved a versionadded into the "Appeareance" page section.

Commits:

	Summary	ID
	Update the My Account page documentation and add new settings. The My Account page docs were pretty out-of-date, lacking changes made since Review Board 7. It was also fairly inconsistent on how it presented available options and descriptions. This reworks sections of the page to provide more guidance and less dense text. It also adds the missing settings, including: * The new Ship It! confirmation and spell check settings. * The Appearance page, added in Review Board 7. Anchors have been added throughout the page to facilitate linking to sections from other pages and release notes.	29902f139397808390c4b7a04f3e14d7e8ed6961
	Update the My Account page documentation and add new settings. The My Account page docs were pretty out-of-date, lacking changes made since Review Board 7. It was also fairly inconsistent on how it presented available options and descriptions. This reworks sections of the page to provide more guidance and less dense text. It also adds the missing settings, including: * The new Ship It! confirmation and spell check settings. * The Appearance page, added in Review Board 7. Anchors have been added throughout the page to facilitate linking to sections from other pages and release notes.	c2409b5b81272b1ce3be3c29b1cb5b34b85ac4fe

Diff:

Revision 2 (+478 -102)

Show changes

docs/manual/users/settings.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

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