Code review comment for lp:~blake-rouse/maas/fix-1598175

Code looks pretty good (see a few comments below, though).

"Needs fixing", though, because I don't see any docstring updates. We need to explain to API users what [new] states editing is allowed in, and which values can be updated.