[Docs] Add vault upgrade explanation

[kbrizzle]

No description provided.

[github-actions]

[Vaults] Unit Test Coverage Report

Coverage after merging britz/vault-dev-docs into dev2 will be

0.00%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
packages/perennial-vaults/contracts/balanced
BalancedVault.sol	0%	0%	0%	0%	113, 113–115, 118–119, 123, 127–128, 128, 128–129, 138, 147–148, 157–158, 158, 158, 160, 160, 160–164, 166–169, 172, 174, 185, 185, 185, 187–188, 188, 188, 190, 190, 190–194, 196–199, 202, 204, 212, 214–218, 221–223, 223, 223, 225, 227, 237–239, 248–249, 259–260, 268–269, 277–278, 287–288, 296–297, 306–307, 316–317, 326–327, 335, 335, 335, 344–345, 345, 345, 350, 359–360, 360, 360, 365, 376, 378, 378, 378–383, 385–386, 388–391, 393, 395–396, 399–402, 405, 405, 405–406, 406, 406–411, 413, 413, 413–419, 421, 432–433, 442–443, 443, 443–444, 447–448, 450, 450, 450–452, 452, 452–453, 457–458, 460, 460, 460–462, 462, 462–463, 474, 478, 478, 478–479, 482–484, 484, 484, 484, 484, 486–487, 489–490, 500, 502, 502, 502, 504–506, 506, 508, 511, 511, 511, 513–515, 515, 515, 517, 527, 529, 529, 529–531, 531, 531–532, 541–543, 551, 560–561, 572, 572, 572–573, 583–585, 588, 598–599, 611, 611, 611–613, 613, 613, 615, 625, 625, 625, 625, 625, 625, 625, 637, 637, 637–639, 639, 639, 654, 654, 654–655, 658–659, 661–662, 664, 666–667, 669–670, 672–674, 676, 685, 689, 689, 689, 698, 698, 698–699, 709, 709, 709–710, 719, 719, 719–720, 730, 730, 730–731, 741–742, 752–753, 761–763, 776, 776, 776–777, 787, 787, 787–788, 798–800, 804, 813, 824–825, 828, 838–839, 841, 855, 855, 855–857, 857, 857
BalancedVaultDefinition.sol	0%	0%	0%	0%	100, 100, 100–101, 101, 101, 103–104, 104, 104–105, 105, 105–106, 106, 106–107, 107, 107, 109–111, 111, 111–112, 112, 112–113, 113, 113, 115–116, 116, 116, 119, 119, 119, 121–123, 125, 125, 125, 127–128, 128, 128–131, 131, 131–132, 132, 132, 143, 143, 143–144, 144, 144, 146, 81, 81, 81, 83–86, 88, 90–91, 91, 91–93, 95, 95, 95–96, 96, 96–97, 97, 97, 99, 99, 99
packages/perennial-vaults/contracts/interfaces
IBalancedVault.sol	100%	100%	100%	100%
IBalancedVaultDefinition.sol	100%	100%	100%	100%

[github-actions]

Integration Test Coverage Report

Coverage after merging britz/vault-dev-docs into dev2 will be

49.36%

Coverage Report

File	Stmts	Branches	Funcs	Lines	Uncovered Lines
packages/perennial/contracts/collateral
Collateral.sol	83.57%	65%	100%	96.72%	110, 112–113, 120–121, 161, 212, 236, 236, 246, 257, 278–279, 53, 55–57, 86, 88–89, 91–93
packages/perennial/contracts/collateral/types
OptimisticLedger.sol	100%	100%	100%	100%
packages/perennial/contracts/controller
Controller.sol	75.96%	48.44%	88.37%	92.11%	126, 140, 153, 166–167, 181–182, 191–192, 201–202, 211–212, 221–222, 232–233, 243–244, 254–255, 265, 274, 283, 292, 312, 320, 329, 337, 355, 355, 355–356, 376, 386, 392, 399, 60, 85
UControllerProvider.sol	74.36%	56.25%	87.50%	86.67%	33–34, 40, 47, 54, 54, 54, 56, 61
packages/perennial/contracts/incentivizer
Incentivizer.sol	81.82%	58.62%	100%	96.67%	128, 140, 153, 166, 168, 183–184, 201, 213, 300, 310, 332, 339, 42–45, 50–53, 83–86, 97
packages/perennial/contracts/incentivizer/types
ProductManager.sol	94.03%	75%	100%	97.73%	158–159, 163, 223
Program.sol	100%	100%	100%	100%
packages/perennial/contracts/interfaces
ICollateral.sol	100%	100%	100%	100%
IContractPayoffProvider.sol	100%	100%	100%	100%
IController.sol	100%	100%	100%	100%
IIncentivizer.sol	100%	100%	100%	100%
IMultiInvoker.sol	100%	100%	100%	100%
IMultiInvokerRollup.sol	100%	100%	100%	100%
IParamProvider.sol	100%	100%	100%	100%
IPayoffProvider.sol	100%	100%	100%	100%
IPerennialLens.sol	100%	100%	100%	100%
IProduct.sol	100%	100%	100%	100%
packages/perennial/contracts/interfaces/types
Accumulator.sol	60%	100%	60%	60%	30, 40
PackedAccumulator.sol	0%	100%	0%	0%	28
PackedPosition.sol	0%	100%	0%	0%	28
PayoffDefinition.sol	0%	0%	0%	0%	107, 111, 113–115, 121, 39, 39, 39, 42, 55–57, 60, 60, 60–61, 61, 65, 65, 65–66, 66, 79, 79, 79, 81, 94, 97
PendingFeeUpdates.sol	0%	0%	0%	0%	104, 108, 115, 34, 34, 34–36, 41, 51, 51, 51–53, 58, 68, 68, 68–70, 75, 80, 80, 80, 80, 80, 85–90
Position.sol	35.71%	0%	41.67%	41.67%	107, 126, 144, 144, 144, 156, 156, 156, 33, 42, 52
PrePosition.sol	0%	0%	0%	0%	112, 114, 119–120, 134–135, 135, 135, 40, 50–51, 61–62, 72–73, 83–84, 98
ProgramInfo.sol	80%	33.33%	100%	100%	51–52, 52, 52
packages/perennial/contracts/lens
PerennialLens.sol	0%	0%	0%	0%	103, 103, 106–116, 133, 142, 151–160, 168, 168–169, 177, 177–178, 186, 186–187, 19, 195, 195–196, 205, 205–206, 214, 214–215, 226, 226, 229–231, 240, 240–242, 250, 250–252, 261, 261–263, 265–266, 27, 274, 274–275, 292, 292–293, 302, 302–303, 312, 312–313, 322, 322–323, 334, 334, 337, 348, 348, 351, 363, 363, 366, 375, 375–376, 387, 387, 39, 390, 399, 399, 40, 400–401, 401, 401, 403–404, 404, 404–405, 408–409, 41–42, 423, 423–425, 43, 437, 437, 44, 440, 442–448, 45, 464, 464–471, 490, 500, 513–514, 519–520, 54–56, 65, 65–77, 89–91
packages/perennial/contracts/multiinvoker
MultiInvoker.sol	98.19%	94.23%	100%	100%	356, 372, 50
MultiInvokerRollup.sol	91.84%	85%	92.86%	94.62%	187, 219, 225–226, 228, 239–240, 240, 240, 298, 71
packages/perennial/contracts/periphery
CoordinatorDelegatable.sol	97.92%	95.45%	100%	100%	83
packages/perennial/contracts/product
Product.sol	0%	0%	0%	0%	102–103, 106, 110, 113, 116, 116, 116, 118, 123, 127, 129, 136, 136, 136, 136–138, 155, 158, 158, 158, 161–163, 163, 167, 170, 174, 177, 177, 177, 179, 182, 188, 190, 198, 208, 208–209, 209–210, 210–211, 211–212, 212–213, 213–214, 214–215, 215–216, 216, 218, 22, 220–221, 223–224, 224, 224–226, 229–230, 238, 248, 248–249, 249–250, 250–251, 251–252, 252–253, 253, 255, 259, 261–262, 264–265, 265, 265–267, 270–271, 279, 289, 289–290,