[SAMZA-1177] Improve upgrade documentation for open source releases

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: 0.13.0
• Assignee: Unassigned
• Reporter: Jagadish
• Created: 30/Mar/17 21:27
• Updated: 04/May/17 19:05

Description

Currently, the only form of documentation for a release we have is our release blog-posts on the Apache blog. However, this has several problems:

• No single trail of audits for various releases
• While we allow upgrades to be seamless from previous releases to the next ones, we don't document what breaks when users skip versions (when upgrading).

The Kafka release page at https://kafka.apache.org/documentation/#upgrade is a good reference to emulate.

Issue Links

• is part of: SAMZA-1234 Documentation for 0.13.0 release