• 
      

    Add docstrings with version information to all evolutions.

    Review Request #12290 — Created May 18, 2022 and submitted

    Information

    Review Board
    release-5.0.x

    Reviewers

    Review Board has had a great many database schema changes over its
    lifetime, and the more we add, the harder it is to determine when a
    particular change was made.

    This poses a problem when trying to sort out failed evolution upgrades,
    as sometimes an upgrade is attempted and rolled back with evolution
    information recorded that breaks future attempts at a new upgrade. When
    this happens, it takes a lot of effort to figure out what happened.

    This change updates all evolutions in the codebase to have a docstring
    that specifies the version in which the evolution was added. This rounds
    up to the first public release (so no alphas/betas).

    All upgrades are also tracked in Notion, for easy reference:

    https://reviewboard.notion.site/Database-Schema-Changes-38702981914e48a3b32f2a3dc5243a5c

    While here, I found a stray evolution that was never used (its contents
    were incorporated into another evolution). That's been deleted.

    Went through and verified the versions of each of these.

    Summary ID
    Add docstrings with version information to all evolutions.
    Review Board has had a great many database schema changes over its lifetime, and the more we add, the harder it is to determine when a particular change was made. This poses a problem when trying to sort out failed evolution upgrades, as sometimes an upgrade is attempted and rolled back with evolution information recorded that breaks future attempts at a new upgrade. When this happens, it takes a lot of effort to figure out what happened. This change updates all evolutions in the codebase to have a docstring that specifies the version in which the evolution was added. This rounds up to the first public release (so no alphas/betas). All upgrades are also tracked in Notion, for easy reference: https://reviewboard.notion.site/Database-Schema-Changes-38702981914e48a3b32f2a3dc5243a5c
    c7a12978959812b5af81f7b01993858fff356e45
    david
    1. Ship It!
    2. 
        
    chipx86
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to release-5.0.x (0574d87)