Today "How Reboot works" (documentation/docs/concepts.mdx, under "Let Reboot generate the ID") and the "Call your API" overview (documentation/docs/call/overview.mdx, under "Constructing instances") recommend letting the framework generate the state ID. That only works with an explicit constructor (factory=True); implicit construction still needs a caller-chosen ID, so both pages have to hedge and explain the difference.
Once framework-generated IDs for implicit construction land, revisit both pages so the advice is simply "let Reboot generate it", and drop the explanation of when a caller has to choose the ID.
Work in progress on that feature: reboot-dev/mono#5579 and reboot-dev/mono#5585.
Today "How Reboot works" (
documentation/docs/concepts.mdx, under "Let Reboot generate the ID") and the "Call your API" overview (documentation/docs/call/overview.mdx, under "Constructing instances") recommend letting the framework generate the state ID. That only works with an explicit constructor (factory=True); implicit construction still needs a caller-chosen ID, so both pages have to hedge and explain the difference.Once framework-generated IDs for implicit construction land, revisit both pages so the advice is simply "let Reboot generate it", and drop the explanation of when a caller has to choose the ID.
Work in progress on that feature: reboot-dev/mono#5579 and reboot-dev/mono#5585.