Add draft release notes for 5.0 beta 1.

Review Request #12374 — Created June 15, 2022 and submitted

Information

Review Board
release-5.0.x

Reviewers

This adds the release notes draft covering everything that we're
shipping in beta 1.

Built HTML and checked the output.

Summary ID
Add draft release notes for 5.0 beta 1.
This adds the release notes draft covering everything that we're shipping in beta 1. Testing Done: Built HTML and checked the output.
31ffbab6768e092f19013a2585a970b935a62d0e
Description From Last Updated

Two small changes to add: Extensions that failed to load had the wrong text for reloading extensions. Fix problems that …

chipx86chipx86

I have one more thing that needs to go in (/r/12437), which will need to be included in here. (That …

chipx86chipx86

Let's reference the doc: :doc:`4.0.7`

chipx86chipx86

pip3

chipx86chipx86

I don't think we need this now that this is all on https.

chipx86chipx86

http -> https in these.

chipx86chipx86

Also: oauth2_provider_accesstoken oauth2_provider_application oauth2_provider_grant oauth2_provider_idtoken oauth2_provider_refreshtoken reviewboard_oauth_application

chipx86chipx86

Let's be explicit about the beta status of each.

chipx86chipx86

"or higher" isn't quite right, since there's explicit ranges that are supported.

chipx86chipx86

We can use :pypi: here.

chipx86chipx86

Only one blank line needed between parent and child sections with no content.

chipx86chipx86

Let's move "Review Board now ..." to its own paragraph so it's less buried.

chipx86chipx86

Let's link to these. We should probably draft integration pages on https://www.reviewboard.org/integrations/ for each by release. Helps with references and …

chipx86chipx86

Two blank lines before reference definition blocks.

chipx86chipx86

No need for the trailing period in the section header.

chipx86chipx86

Let's switch these to pip3.

chipx86chipx86

We should probably tell people where to go to find this.

chipx86chipx86

Typo: Pyments -> Pygments

maubinmaubin

We can say that this is the start, and that we have further improvements coming in beta 2.

chipx86chipx86

This needs to be double backticks in ReST. The table name is scmtools_tool though.

chipx86chipx86

Same here.

chipx86chipx86

Should be Title Case.

chipx86chipx86

Should be Title Case.

chipx86chipx86

Let's put these in alphabetical order.

chipx86chipx86

So I wasn't going to make this a beta, but now I'm wondering if we should... And if we should, …

chipx86chipx86
david
maubin
  1. 
      
  2. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Typo: Pyments -> Pygments

  3. 
      
chipx86
  1. 
      
  2. Show all issues

    Two small changes to add:

    • Extensions that failed to load had the wrong text for reloading extensions.
    • Fix problems that could occur with setting up an environment for running brz for Breezy (more likely to affect unit tests, but still).
  3. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
    Show all issues

    Let's reference the doc:

    :doc:`4.0.7`
    
  4. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    pip3

  5. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    I don't think we need this now that this is all on https.

  6. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
    Show all issues

    http -> https in these.

  7. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Also:

    • oauth2_provider_accesstoken
    • oauth2_provider_application
    • oauth2_provider_grant
    • oauth2_provider_idtoken
    • oauth2_provider_refreshtoken
    • reviewboard_oauth_application
  8. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    Show all issues

    Let's be explicit about the beta status of each.

  9. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
     
     
    Show all issues

    "or higher" isn't quite right, since there's explicit ranges that are supported.

  10. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    We can use :pypi: here.

  11. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
     
    Show all issues

    Only one blank line needed between parent and child sections with no content.

  12. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
    Show all issues

    Let's move "Review Board now ..." to its own paragraph so it's less buried.

  13. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Let's link to these.

    We should probably draft integration pages on https://www.reviewboard.org/integrations/ for each by release. Helps with references and SEO. Wanna put a task in Asana for this?

  14. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
    Show all issues

    Two blank lines before reference definition blocks.

  15. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    No need for the trailing period in the section header.

  16. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
     
    Show all issues

    Let's switch these to pip3.

  17. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
     
     
    Show all issues

    We should probably tell people where to go to find this.

  18. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
     
     
    Show all issues

    We can say that this is the start, and that we have further improvements coming in beta 2.

  19. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    This needs to be double backticks in ReST.

    The table name is scmtools_tool though.

  20. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Same here.

  21. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Should be Title Case.

  22. docs/releasenotes/5.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    Should be Title Case.

  23. 
      
david
chipx86
  1. 
      
  2. Show all issues

    I have one more thing that needs to go in (/r/12437), which will need to be included in here.

    (That change targets 5.0 beta 1 for now, and will be backported to 4.0.8 after.)

  3. docs/releasenotes/5.0-beta-1.rst (Diff revision 3)
     
     
     
     
     
     
     
     
    Show all issues

    Let's put these in alphabetical order.

  4. docs/releasenotes/5.0-beta-1.rst (Diff revision 3)
     
     
    Show all issues

    So I wasn't going to make this a beta, but now I'm wondering if we should...

    And if we should, we'll need this in the pip instructions above.

    1. No need to change your plans, unless you actually expect more changes. I'll just revert this one.

  5. 
      
david
david
david
chipx86
  1. Ship It!
  2. 
      
david
Review request changed
Status:
Completed
Change Summary:
Pushed to release-5.0.x (4a29886)