I like the clean simple layout of v3. It appears to have these elements
- Version Control Strategy Name
- Usage Scenarios
But each time I read one, I find myself wanting to see two sections like
I don't care the language. You get the idea. The usage scenarios hint at the advantages (where it might be an advantage to use.). The Considerations hint at the downsides. They tell you how to implement it sensibly. But I keep filling in the "gotchas"
in my mind.
I don't know whether this resonates with any of the developers. But if you find something like that seeking to leap out of your minds onto the screen, feel free to try it out and let's see if it adds value while still preserving the clean and concise nature
of v3. I, myself, am not skilled at concise :)