To be fair… Flakes are still marked as an experimental feature, so they are telling you it probably won’t be documented and the interface could change. But yes, given how widely adopted they are in the community, it’s definitely time to document them better and ideally make it the default for new setups.