Add release notes for Review Board 6.0 beta 1.
Review Request #12929 — Created March 30, 2023 and submitted
Information | |
---|---|
david | |
Review Board | |
release-6.x | |
Reviewers | |
reviewboard | |
This change adds the draft release notes for beta 1.
Built html and viewed the output.
Summary | |
---|---|
Description | From | Last Updated |
---|---|---|
5.0.4 now. |
|
|
5.0.4 has a revised list/ordering here, which includes a link to Docker instructions. |
|
|
I think this should be explicit in the first sentence that Review Board's extension framework has had a concept of … |
|
|
Bug Fixes is typically last (though it can be before Internal API Changes). |
|
|
I wonder if we should just make this "Extensions", because that's the audience reading this that would be most interested … |
|
|
"If you maintain extensions ..." should be its own sentence. Alternatively, if this is in an Extensions section, then we … |
|
|
We should really update the docs on how to use TypeScript in extensions (since we need an index.ts file to … |
|
|
Two blank lines before reference definitions. |
|
|
Two blank lines before reference definitions. |
|
|
Let's move this right below Bug Fixes, to keep defect-related info together. I suspect most users won't read past the … |
|
|
The vital information/mitigation get lost here, since there's so much information in this paragraph. I think this'll read better if … |
|
-
-
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) 5.0.4 has a revised list/ordering here, which includes a link to Docker instructions.
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) I think this should be explicit in the first sentence that Review Board's extension framework has had a concept of actions. This feature won't mean anything to the average user.
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) Bug Fixes is typically last (though it can be before Internal API Changes).
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) I wonder if we should just make this "Extensions", because that's the audience reading this that would be most interested in this changes (and may not know the internal changes apply to them).
We may then want to put the Actions changes in this section as well.
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) "If you maintain extensions ..." should be its own sentence.
Alternatively, if this is in an Extensions section, then we may just want to get rid of the "particular impact on users" bit and instead say developers can now more easily integrate tools like mypy or pyright.
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 1) We should really update the docs on how to use TypeScript in extensions (since we need an
index.ts
file to trigger Rollup -- maybe worth mentioning that instead of.ts
generally).Can you file a task for tracking an update to extension media docs?
Commits: |
|
|||||||||
---|---|---|---|---|---|---|---|---|---|---|
Diff: |
Revision 2 (+418) |
Checks run (2 succeeded)
Commits: |
|
|||||||||
---|---|---|---|---|---|---|---|---|---|---|
Diff: |
Revision 3 (+446) |
Checks run (2 succeeded)
-
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 3) Let's move this right below Bug Fixes, to keep defect-related info together. I suspect most users won't read past the internal changes info.
-
docs/releasenotes/6.0-beta-1.rst (Diff revision 3) The vital information/mitigation get lost here, since there's so much information in this paragraph. I think this'll read better if we split it up like:
* When a review request is open in multiple browser tabs/windows, if the review is discarded from one tab, attempts to create or edit comments from another tab will result in errors. This bug was technically present in earlier versions, but due to the way things are loaded from the server, it's now a lot easier to hit. The best way to avoid this for now is to avoid opening the same review request in multiple browser tabs.
Bullet point will keep it together as one "known issue" (even though we don't have others) and will be more consistent with how we typically do Bug Fixes and such.
Commits: |
|
|||||||||
---|---|---|---|---|---|---|---|---|---|---|
Diff: |
Revision 4 (+458) |