Your two sibling comments are currently "Why is the comfort of the aggressor more important than the comfort of the innocent victim?" And "Yes." The assumption that some people in this thread are in favor of violence seems to be borne out.
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.