For each major release, we have a page such as:
This page is to collaborate on guidelines for these pages. Goals:
- Help people decide if they should upgrade
- Help people understand Tiki (know what it does, and what is evolving)
Sections: 1. Infrastructure
- Useful, but shouldn't add new features or affect end users (Smarty, jQuery, build system PHPUnit..., refactoring)
2. Enhancement
- New feature (big or small), (UI / UX improvement), replacements (which affect end user), notable bug fixes, etc.
3. Removals
4. Upgrade notes
- Known issues / regressions which may prevent you from upgrading / a change which may be disruptive
See also Commit Tags