As a user of DS software and especially DS servers, I need to know what has changed before I upgrade my production environment. Today this involves reading one or more sets of release notes (more than one if I have skipped a release), upgrading test instances and testing, maybe further investigation including reading more documentation when things break. If my directory services are working fine and I don't need (or am not aware that I need) new features, I am hesitant to upgrade because the upgrade might break something.
It would be helpful to have a feature that could compare the version I am upgrading to with the version I am upgrading from before upgrade, and generate a report including:
- Compatibility changes that affect the upgraded software (deprecations, removals)
- Compatibility changes reflecting updated best practices such as new defaults that won't be applied to the upgraded software, but that I should seriously consider (e.g. for security reasons)
- Steps I will need to take after upgrade
- Whether the upgrade is expected to involve long running processes (e.g. because the database format changed an upgrade will require reindexing all attributes)
For extra credit, it would be nice if the same feature could be used to generate the source of the generic compatibility documentation that we publish.