phetsims / graphing-quadratics

"Graphing Quadratics" is an educational simulation in HTML5, by PhET Interactive Simulations.
MIT License
1 stars 4 forks source link

Migration rules for 1.3 release #179

Closed pixelzoom closed 1 year ago

pixelzoom commented 2 years ago

178 (add support for dynamic locale) will certainly result in many API changes. According to the PhET-iO spreadsheet, this sim needs to provide support migration from 1.2 to 1.3. So migration rules will be needed.

samreid commented 1 year ago

I'll reassign this when we get closer to that stage. Self-unassigning for now.

zepumph commented 1 year ago

Unassigning until we work on this sim.

pixelzoom commented 1 year ago

Migration rules for Molecule Polarity https://github.com/phetsims/molecule-polarity/issues/141 was quite the project. @samreid suggested that, while it's still fresh in my mind, I should do this sim. @kathy-phet approved. So I'll proceed.

pixelzoom commented 1 year ago

This sim went very quicky, ~1 hour. Almost everything could be reused from molecule-polarity-migration-rules.ts or natural-selection-migration-rules.ts. Tested with ?strictMigrationRules.

Completion is now blocked by:

zepumph commented 1 year ago

This is no longer blocked by https://github.com/phetsims/phet-io-wrappers/issues/513 (note it is still out for review though). You will likely need AboutDialog rules from molecule polarity.

pixelzoom commented 1 year ago

In the above commit, I added rules for element aboutDialog by copying them from molecule-polarity-migration-rules.ts. This sim has no Options dialog, so I did not need to add rules for element optionsDialog.

pixelzoom commented 1 year ago

All migration rules are currently in place. This will need to be tested/reviewed again before we begin the 1.3 release process, but for now there is no more work to be done.

pixelzoom commented 1 year ago

Getting this sim ready for dev testing is a task for June 9-29 iteration, so relabeling this issue accordingly.

pixelzoom commented 1 year ago

Since CT and git-hooks are not checking migration rules, they can be (and have been) broken. So self-assigning to check migration rules just before dev testing, and just before creating the RC branch.

pixelzoom commented 1 year ago

QA instructions for dev test https://github.com/phetsims/qa/issues/959:

KatieWoe commented 1 year ago

Things look ok from what we've seen.

pixelzoom commented 1 year ago

Leaving this assigned to me. It needs to be checked again just before creating the 1.3 release branch.

pixelzoom commented 1 year ago

I tested the Migration wrapper before creating the 1.3 release branch, and there were no problems. Please test again for 1.3.0-rc.1, and close this issue if everything looks OK.

KatieWoe commented 1 year ago

Migration looked ok in rc.1

pixelzoom commented 1 year ago

Reopening. https://github.com/phetsims/graphing-quadratics/issues/202 will require API and migration rule changes, so this issue will need to be verified again for 1.3.0-rc.2.

pixelzoom commented 1 year ago

Ready for testing with the Migration wrapper in 1.3.0-rc.2. Please assign back to me when testing is completed.

KatieWoe commented 1 year ago

Migration looked ok in 1.3.0-rc.2. Focused around point tool focus.

pixelzoom commented 1 year ago

This is not necessary to test in 1.3.0-rc.3, because the only issue to address is https://github.com/phetsims/graphing-quadratics/issues/203, which involved no changes to migration rules.

pixelzoom commented 1 year ago

Proceeding with publication of 1.3.0, so it's now safe to close this issue.