Draft release notes for 3.0 beta 1.

Review Request #8590 — Created Jan. 4, 2017 and submitted

Information

Review Board
release-3.0.x
a7728cc...

Reviewers

This incorporates all the changes on release-3.0.x which aren't present on
release-2.5.x. Some of the links to rb3.0:... pages don't yet work since we
don't explicitly have "3.0" documentation on the website yet.

Built HTML. Ran spellcheck.

Description From Last Updated

We should note the new user infobox.

chipx86chipx86

A few more things that are in this release that aren't (yet) in a shipped 2.5: Bitbucket has been updated …

chipx86chipx86

We might also want to say a little bit about feature checks and how admins will be able to use …

chipx86chipx86

I think the last thing in here we'll need to add is something about the Bazaar changes. Can keep it …

chipx86chipx86

"from"

brenniebrennie

We should prefer pip now, with a fallback to easy_install. See https://reviews.reviewboard.org/r/8848/diff/

chipx86chipx86

Can we have bullet points for both of these?

chipx86chipx86

Let's also put up a section announcing Slack support. I know we say it here, but highlighting it as its …

chipx86chipx86

Let's link Review Bot to the GitHub repo.

chipx86chipx86

We should credit Shuai Shao for starting this work off, I think.

mike_conleymike_conley

Let's say "administrator" instead of "superuser." it's less Django-y and more correct when it comes to RBCommons (assuming that's been …

chipx86chipx86

This is the only one that doesn't say "Improvements". Though, I'm not sure we need "Improvements" on any of those …

chipx86chipx86

Should be in sentence casing with a trailing period.

chipx86chipx86

Should be in sentence casing with a trailing period. I would also put this into Review Improvements. I know this …

chipx86chipx86

Should be in sentence casing with a trailing period.

chipx86chipx86

Let's move this into a Search section, and include the on-the-fly indexing.

chipx86chipx86

It's just "Elasticsearch".

chipx86chipx86

Let's move this into a Review Request section, along with reassigning ownership.

chipx86chipx86

Let's move this into a New Administration Features section.

chipx86chipx86

I don't know that we need the history here. Most people don't care about Google Code anymore. Let's instead say …

chipx86chipx86

It took me a moment to realize what we were talking about (I was thinking a users list on a …

chipx86chipx86

Let's move this into a New Administration Features section.

chipx86chipx86

This is in 2.5.

chipx86chipx86

Needs to be added to AUTHORS.

chipx86chipx86

Needs to be added to AUTHORS.

chipx86chipx86

Needs to be added to AUTHORS.

chipx86chipx86

Needs to be added to AUTHORS.

chipx86chipx86

Two blank lines.

chipx86chipx86
reviewbot
  1. Tool: PEP8 Style Checker
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
    
    Tool: Pyflakes
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
  2. 
      
david
reviewbot
  1. Tool: Pyflakes
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
    
    Tool: PEP8 Style Checker
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
  2. 
      
brennie
  1. 
      
  2. docs/releasenotes/3.0-beta-1.rst (Diff revision 2)
     
     
    Show all issues

    "from"

  3. 
      
david
reviewbot
  1. Tool: PEP8 Style Checker
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
    
    Tool: Pyflakes
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
  2. 
      
david
reviewbot
  1. Tool: Pyflakes
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
    
    Tool: PEP8 Style Checker
    Ignored Files:
        docs/releasenotes/index.rst
        docs/releasenotes/3.0-beta-1.rst
    
    
  2. 
      
mike_conley
  1. 
      
  2. docs/releasenotes/3.0-beta-1.rst (Diff revision 4)
     
     
    Show all issues

    We should credit Shuai Shao for starting this work off, I think.

  3. 
      
chipx86
  1. 
      
  2. Show all issues

    We should note the new user infobox.

  3. Show all issues

    A few more things that are in this release that aren't (yet) in a shipped 2.5:

    • Bitbucket has been updated to use the 2.0 API, fixing compatibility problems in some setups (3b9c6c5)
    • Fixed confirming before leaving the page when there's unsaved work (176916d)
    • Fixed errors saving a group when there's inactive users (6897531)
    • Fixed a compatibility issue with Mercurial (4735e27)
    • Several fixes for move detection (151e986, 2f9f515, dde9df0, eb3c939)
    • Fixed the whitespace changes only banner being duplicated when expanding/collapsing headers. (4f5e2f5)
  4. Show all issues

    We might also want to say a little bit about feature checks and how admins will be able to use that going forward to opt into new experimental features.

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

    We should prefer pip now, with a fallback to easy_install. See https://reviews.reviewboard.org/r/8848/diff/

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

    Can we have bullet points for both of these?

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

    Let's link Review Bot to the GitHub repo.

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

    Let's say "administrator" instead of "superuser." it's less Django-y and more correct when it comes to RBCommons (assuming that's been implemented right for Local Sites).

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

    This is the only one that doesn't say "Improvements". Though, I'm not sure we need "Improvements" on any of those (we don't typically do that in the release notes, and these are under New User Features anyway).

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

    Should be in sentence casing with a trailing period.

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

    Should be in sentence casing with a trailing period.

    I would also put this into Review Improvements. I know this can be done for the review request text fields as well, but it's probably more likely for reviews, and having it there would help highlight this feature better.

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

    Should be in sentence casing with a trailing period.

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

    Let's move this into a Search section, and include the on-the-fly indexing.

    1. on-the-fly indexing isnt in yet :)

    2. Yep, jumped the gun :)

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

    It's just "Elasticsearch".

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

    Let's move this into a Review Request section, along with reassigning ownership.

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

    Let's move this into a New Administration Features section.

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

    I don't know that we need the history here. Most people don't care about Google Code anymore. Let's instead say something like:

    "Splat is a new bug tracker service we currently have in development, designed to be flexible in its usage and to tie into other project management tools. It's being used to track bugs and features for Review Board, and will in time be available for others to use."

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

    It took me a moment to realize what we were talking about (I was thinking a users list on a review request). Maybe say the "users list page".

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

    Let's move this into a New Administration Features section.

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

    This is in 2.5.

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

    Needs to be added to AUTHORS.

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

    Needs to be added to AUTHORS.

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

    Needs to be added to AUTHORS.

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

    Needs to be added to AUTHORS.

  25. docs/releasenotes/index.rst (Diff revision 4)
     
     
     
     
    Show all issues

    Two blank lines.

  26. 
      
chipx86
  1. 
      
  2. docs/releasenotes/3.0-beta-1.rst (Diff revision 4)
     
     
     
    Show all issues

    Let's also put up a section announcing Slack support. I know we say it here, but highlighting it as its own section would also be good. People will be excited about that :)

  3. 
      
david
chipx86
  1. 
      
  2. Show all issues

    I think the last thing in here we'll need to add is something about the Bazaar changes. Can keep it simple by saying we've rewritten the Bazaar support to use the command line tool, improving compatibility and ensuring we stay license-compliant, and that 2.0 and 2.5 will soon be receiving this fix as well.

  3. 
      
david
chipx86
  1. Ship It!
  2. 
      
david
Review request changed
Status:
Completed
Change Summary:
Pushed to release-3.0.x (d5bded4)