Add docstrings with version information to all evolutions.

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

chipx86
Review Board
release-5.0.x
reviewboard

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
Add docstrings with version information to all evolutions.
david
  1. Ship It!
  2. 
      
chipx86
Review request changed

Status: Closed (submitted)

Change Summary:

Pushed to release-5.0.x (0574d87)
Loading...