Yesterday I edited 2 of the 3 almost empty Documentation sections of the Introduction to Lucene topic. When I checked the status of my proposed change today I noticed that about an hour after I submitted my proposal, another user submitted a similar edit proposal but with a rather different Hello World example than mine. I guess he wasn't aware of my proposed change.
If I understood this meta question correctly Documentation treats multiple edits as linear, so if one of either edit gets approved, the second edit will propose significant changes to the first one so it's bound to be rejected.
Wouldn't it be better if a Documentation section is locked (or at least the affected section part is) while it awaits approval for a proposed edit? Sure it may slow down writing a bit, but it will prevent people from getting frustrated because their perfectly fine edit got rejected.
Addendum: it looks like a lot of people encountered similar problems:
- Documentation edit which is approved is entirely rewritten with the next edit
- Very Confused by Documentation (multiple edits, reviews, and conflicting Accepts and Rejects)
- Issues with Edits and Reviewing Edits on Documentation
- Edit of Remarks rejected due to proposed changed on an example
At the very least I think that it should be made more clear to editors if the section they want to edit already has proposed changes. Right now, the 'all topics view' of a tag does show proposed changes nicely, but I haven't seen any message whatsoever you when you are reading topic contents and decide to edit it.