User story:

We are currently are running 5.4.14 so we want to understand when is best to upgrade to maximise the improvements available. We also want to understand the needs to upgrade and any tips you have. – American Express

Improve the Upgrading to Magnolia 5.6 page with practical tips and lessons learned from client upgrades. bandersen and rgange have guided clients through the 5.4-to-5.6 process. Ask them to provide the content.

Acceptance criteria:

• Upgrade instructions are realistic and set the right expectations.
  • Example: There's no point in trying "migrate" STK templates. Just rewrite them.
• Include lessons learned from actual upgrades.
• Identify common pitfalls. 

Ideas:

• Add "Lessons learned" info boxes in relevant places on the page.
• Consider moving the upgrade page under 5.6 release notes. Current location under the Administration section is hard to find.