We tend to prepare too many directories. This is like preparing too many drawers most of which end up empty. It is hard to find things if we have so many fake drawers.
For example, we might prepare like this.
doc/internal/ spec/, note/, verification/, test/, ... doc/public/ manual/, releasenote/
Note that doc/external holds only two items. Then this case should better be treated exceptional; for example,
doc/ spec/, note/, verification/, test/, ... doc/public/ manual/, releasenote/
Long version number is another case of over preparation.
- myprogram version 188.8.131.52
The middle digits in those version numbers never get incremented. Often the first digit never gets 2. I often use much simpler version such as
- myprogram version 3a
which I believe is easier to say.