Having spoken to a some people involved with the project, my understanding is that there's a significant schism between factions "Flakes are unfinished software, and our documentation should not focus on them" and "Flakes are what the majority of the userbase is using, and we should document them". I hope this will eventually get better if Flakes are ever stabilized.