Summary

Rewrite the FAQ for all of our modern positioning.

Review Request #15292 — Created Sept. 12, 2026 and updated Sept. 12, 2026, 10:45 p.m.

Information

Owner

chipx86

Repository

Review Board

Branch

release-8.x

Bugs

Depends On

Reviewers

Groups

reviewboard

People

Description

This change rewrites our FAQ to go into a lot more depth on topics
important for people evaluating Review Board today, including:

Who Review Board is for, and who it's not
Support for on-prem/air-gapped environments
The types of projects and assets that can be reviewed
The various review features for different assets
Upcoming support for EDA review
Details on automation and AI
How Review Board treats data, and data portability
Deployment sizes
Migration from other services
Support offerings
Paid plans

This makes it a longer FAQ, but it's organized into sections that make
it easier to find suitable questions via the modern docs UI sidebar.

Testing Done

Built the docs and went through them, checking for glaring issues.

Ran link checks.

Performed several editing passes with ChatGPT.

Commits

Summary	ID
Rewrite the FAQ for all of our modern positioning. The recent work on the information page built for AI agents resulted in a lot of great talking points that we weren't communicating in any single place for humans looking to learn more about Review Board. This change rewrites our FAQ to go into a lot more depth on topics important for people evaluating Review Board today, including: * Who Review Board is for, and who it's not * Support for on-prem/air-gapped environments * The types of projects and assets that can be reviewed * The various review features for different assets * Upcoming support for EDA review * Details on automation and AI * How Review Board treats data, and data portability * Deployment sizes * Migration from other services * Support offerings * Paid plans This makes it a longer FAQ, but it's organized into sections that make it easier to find suitable questions via the modern docs UI sidebar.	0232243735c6b52d58976b55abbad8e5163e659e

Summary

Rewrite the FAQ for all of our modern positioning.

The recent work on the information page built for AI agents resulted in a lot of great talking points that we weren't communicating in any single place for humans looking to learn more about Review Board. This change rewrites our FAQ to go into a lot more depth on topics important for people evaluating Review Board today, including: * Who Review Board is for, and who it's not * Support for on-prem/air-gapped environments * The types of projects and assets that can be reviewed * The various review features for different assets * Upcoming support for EDA review * Details on automation and AI * How Review Board treats data, and data portability * Deployment sizes * Migration from other services * Support offerings * Paid plans This makes it a longer FAQ, but it's organized into sections that make it easier to find suitable questions via the modern docs UI sidebar.

0232243735c6b52d58976b55abbad8e5163e659e

Issues

Description	From	Last Updated
You have three separate, almost identical paragraphs about "honest assesment". Two of them are pretty close together too.	david	Sept. 12, 2026, 10:19 p.m.
Something is weird here.	david	Sept. 12, 2026, 10:21 p.m.
Other emails in this doc use mailto: (though I think sphinx links it correctly either way)	david	Sept. 12, 2026, 10:10 p.m.
This seems... aspirational	david	Sept. 12, 2026, 10:22 p.m.
Should probably be "They let" or "RBTools lets" to match plurality with "command-line tools"	david	Sept. 12, 2026, 10:23 p.m.
"provide feedback over Continuous Integration" is odd.	david	Sept. 12, 2026, 10:24 p.m.
We should probably mention that it's MIT-licensed here.	david	Sept. 12, 2026, 10:29 p.m.

flake8 passed.

JSHint passed.

The issue has been dropped. Show all issues

You have three separate, almost identical paragraphs about "honest assesment". Two of them are pretty close together too.

chipx86

Sept. 12, 2026, 10:45 p.m.

This is intentional. Not everyone's going to read every entry, and repetition can be helpful for drilling things in (there's a reason that marketing tends to repeat claims or important points over and over). Experiments with AI also show that this can help solidify these points when they read through it. Much of the FAQ makes use of repeating the same concepts throughout.

The first two iterations that are side-by-side use different language to avoid appearing as a copy/paste in close proximity.

docs/manual/faq/index.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Something is weird here.
```

docs/manual/faq/index.rst (Diff revision 1)

The issue has been dropped. Show all issues

Other emails in this doc use mailto: (though I think sphinx links it correctly either way)

chipx86

Sept. 12, 2026, 10:45 p.m.

Sphinx links these. I'm using an e-mail address directly when I want to refer to the e-mail address, and a Markdown link when I'm putting text over it.

docs/manual/faq/index.rst (Diff revision 1)

The issue has been resolved. Show all issues

This seems... aspirational

chipx86

Sept. 12, 2026, 10:45 p.m.

I'll try a tweak. I do want to make sure I mention Dropbox and Google Drive, because I've had multiple conversations now with people who use local programs to review shared files out of those in their organization.

docs/manual/faq/index.rst (Diff revision 1)

We should probably change the actual review UI to say "Side-by-Side" instead of "Two-Up"

chipx86

Sept. 12, 2026, 10:45 p.m.

Probably should. I'm not taking on that work, but I think it'd be a good idea.

docs/manual/faq/index.rst (Diff revision 1)

The issue has been resolved. Show all issues

Should probably be "They let" or "RBTools lets" to match plurality with "command-line tools"

docs/manual/faq/index.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
"provide feedback over Continuous Integration" is odd.
```
1. chipx86
  
  Sept. 12, 2026, 10:45 p.m.
  I'll try to rephrase it.
docs/manual/faq/index.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
We should probably mention that it's MIT-licensed here.
```

Change Summary:


Improved wording around the file uploading.
Improved wording around keeping humans in the loop.
Changed the RBTools command line tools section to say "They let ..."
Reword the CI text.
Added the MIT license text.

Commits:

	Summary	ID
	Rewrite the FAQ for all of our modern positioning. The recent work on the information page built for AI agents resulted in a lot of great talking points that we weren't communicating in any single place for humans looking to learn more about Review Board. This change rewrites our FAQ to go into a lot more depth on topics important for people evaluating Review Board today, including: * Who Review Board is for, and who it's not * Support for on-prem/air-gapped environments * The types of projects and assets that can be reviewed * The various review features for different assets * Upcoming support for EDA review * Details on automation and AI * How Review Board treats data, and data portability * Deployment sizes * Migration from other services * Support offerings * Paid plans This makes it a longer FAQ, but it's organized into sections that make it easier to find suitable questions via the modern docs UI sidebar.	b44f52786ec7dc546c62041d23c501040e9e9ef3
	Rewrite the FAQ for all of our modern positioning. The recent work on the information page built for AI agents resulted in a lot of great talking points that we weren't communicating in any single place for humans looking to learn more about Review Board. This change rewrites our FAQ to go into a lot more depth on topics important for people evaluating Review Board today, including: * Who Review Board is for, and who it's not * Support for on-prem/air-gapped environments * The types of projects and assets that can be reviewed * The various review features for different assets * Upcoming support for EDA review * Details on automation and AI * How Review Board treats data, and data portability * Deployment sizes * Migration from other services * Support offerings * Paid plans This makes it a longer FAQ, but it's organized into sections that make it easier to find suitable questions via the modern docs UI sidebar.	0232243735c6b52d58976b55abbad8e5163e659e

Diff:

Revision 2 (+1062 -208)

Show changes

docs/manual/faq/index.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.