[KAFKA-3851] Add references to important installation/upgrade notes to release notes

• Type: Bug
• Status: Resolved
• Priority: Blocker
• Resolution: Fixed
• Affects Version/s: 0.10.0.0
• Fix Version/s: 0.10.0.1
• Assignee: Ewen Cheslack-Postava
• Reporter: Ewen Cheslack-Postava
• Created: 16/Jun/16 16:41
• Updated: 27/Jul/16 23:00
• Resolved: 27/Jul/16 23:00

Description

Today we use the release notes exactly as exported from JIRA (see "Prepare release notes" on https://cwiki.apache.org/confluence/display/KAFKA/Release+Process) and then rely on users to dig through our documentation (none of which starts with release-specific notes) to upgrade and installation notes.

Especially for folks who aren't intimately familiar with our docs, the information is very easy to miss. Ideally we could automate the release notes process a bit and then have them automatically modified to at least include links at the very top (it'd be nice if we had some other header material added as well since the automatically generated release notes are very barebones...). Even better would be if we could pull in the version-specific installation/upgrade notes directly.

Issue Links

• links to: GitHub Pull Request #1670