IssueTracker

Component used: SavedState

Version used: 1.2.0-alpha02

The docs on SavedStateRegistryOwner do not explain the responsibilities and contract that the owner has on how they should implement SavedStateRegistryOwner or when they should call the methods on SavedStateRegistryController.

Ideally the class docs should talk through:

1. That performAttach() should be called only once, usually as part of the initialization of the owner. It must be called on the main thread.
2. That performRestore should be called unconditionally (either with null if no state is being restored or the Bundle of state to restore) either directly before moving the Lifecycle to CREATED or as part of a LifecycleObserver that is added as part of the initialization of the owner.
3. When the state of the owner is saved, performSave() must be called. The Bundle saved there should be what is later sent to performRestore().