Are you planning to improve your Dovecot 2.4.x documentation? The current 2.4.x documentation has:
- Non-obvious links between 2.4.x and 2.3.x
- Some 2.3.x specific grammar
- Almost no examples
- 2.4.x material is scattered across many pages
- Contains a few inaccuracies
- Contains some contradictions
2.4.x is such a huge change that it should have its own, standalone documentation tree exclusively for 2.4.x. This tree should have a different color scheme than your other docs so people know at a glance exactly what they're looking at.
You could have a page devoted to often used dovecot.conf content, with numerous examples, documented as if there had never been an earlier version. You could have a page devoted to conversion of 2.3.x dovecot.conf to 2.4.x, once again, with numerous examples. Another page with more exotic dovecot.conf content, with numerous examples. Another page discussing the 2.3.x features that don't appear in 2.4.x, what capabilities that takes away, and how best to cobble together those capabilities for those who don't want Dovecot Professional. Another page for brand new capabilities of 2.4.x.
Thanks,
SteveT
Steve Litt http://444domains.com