Improve changelog rendering format (#2169)

* Improve changelog rendering format

Group changelog entries by change type, add a fallback section for
unknown types, and re-render CHANGELOG.md. Also convert legacy
reStructuredText-style links in historical change fragments to Markdown.

* Fix changelog upgrade note links

* Change link from awslabs to aws

Author: jonathan343

.changes/0.5.1.json

@@ -33,7 +33,7 @@
     },
     {
       "category": "deployment",
-      "description": "Handle case where local policy does not exist\n(`29 <https://github.com/awslabs/chalice/issues/29>`__)",
+      "description": "Handle case where local policy does not exist\n([#29](https://github.com/aws/chalice/issues/29))",
       "type": "bugfix"
     }
   ]

.changes/0.6.0.json

@@ -1,6 +1,6 @@
 {
   "schema-version": "0.2",
-  "summary": "Check out the `upgrade notes for 0.6.0\n<http://chalice.readthedocs.io/en/latest/upgrading.html#v0-6-0>`__\nfor more detailed information about changes in this release.\n\n",
+  "summary": "Check out the [upgrade notes for 0.6.0](https://aws.github.io/chalice/upgrading#v0-6-0)\nfor more detailed information about changes in this release.\n\n",
   "changes": [
     {
       "category": "local",

.changes/1.0.0b1.json

@@ -1,6 +1,6 @@
 {
   "schema-version": "0.2",
-  "summary": "Please read the `upgrade notes for 1.0.0b1\n<http://chalice.readthedocs.io/en/latest/upgrading.html#v1-0-0b1>`__\nfor more detailed information about upgrading to this release.\n\nNote: to install this beta version of chalice you must specify\n``pip install 'chalice>=1.0.0b1,<2.0.0'`` or\nuse the ``--pre`` flag for pip: ``pip install --pre chalice``.\n\n",
+  "summary": "Please read the [upgrade notes for 1.0.0b1](https://aws.github.io/chalice/upgrading#b1)\nfor more detailed information about upgrading to this release.\n\nNote: to install this beta version of chalice you must specify\n``pip install 'chalice>=1.0.0b1,<2.0.0'`` or\nuse the ``--pre`` flag for pip: ``pip install --pre chalice``.\n\n",
   "changes": [
     {
       "category": "rest-api",

.changes/1.0.0b2.json

@@ -1,6 +1,6 @@
 {
   "schema-version": "0.2",
-  "summary": "Please read the `upgrade notes for 1.0.0b2\n<http://chalice.readthedocs.io/en/latest/upgrading.html#v1-0-0b2>`__\nfor more detailed information about upgrading to this release.\n\nNote: to install this beta version of chalice you must specify\n``pip install 'chalice>=1.0.0b2,<2.0.0'`` or\nuse the ``--pre`` flag for pip: ``pip install --pre chalice``.\n",
+  "summary": "Please read the [upgrade notes for 1.0.0b2](https://aws.github.io/chalice/upgrading#b2)\nfor more detailed information about upgrading to this release.\n\nNote: to install this beta version of chalice you must specify\n``pip install 'chalice>=1.0.0b2,<2.0.0'`` or\nuse the ``--pre`` flag for pip: ``pip install --pre chalice``.\n",
   "changes": [
     {
       "category": "local",

.changes/1.0.1.json

@@ -13,7 +13,7 @@
     },
     {
       "category": "rest-api",
-      "description": "Fix api gateway stage being set incorrectly in non-default chalice stage\n(`#$70 <https://github.com/aws/chalice/issues/470>`__)",
+      "description": "Fix api gateway stage being set incorrectly in non-default chalice stage\n([#470](https://github.com/aws/chalice/issues/470))",
       "type": "bugfix"
     }
   ]

.changes/1.2.0.json

@@ -1,6 +1,6 @@
 {
   "schema-version": "0.2",
-  "summary": "This release features a rewrite of the core deployment\ncode used in Chalice.  This is a backwards compatible change\nfor users, but you may see changes to the autogenerated\nfiles Chalice creates.\nPlease read the `upgrade notes for 1.2.0\n<http://chalice.readthedocs.io/en/latest/upgrading.html#v1-2-0>`__\nfor more detailed information about upgrading to this release.\n\n",
+  "summary": "This release features a rewrite of the core deployment\ncode used in Chalice.  This is a backwards compatible change\nfor users, but you may see changes to the autogenerated\nfiles Chalice creates.\nPlease read the [upgrade notes for 1.2.0](https://aws.github.io/chalice/upgrading#v1-2-0)\nfor more detailed information about upgrading to this release.\n\n",
   "changes": [
     {
       "category": "rest-api",

.changes/templates/changelog

@@ -1,11 +1,32 @@
-# CHANGELOG
+# Changelog
 
 {% for release, changes in releases %}
-## {{ release }}
+## v{{ release }}
 {% if changes.summary %}
 {{ changes.summary -}}
 {% endif %}
-{% for change in changes.changes %}
-* {{ change.type }}:{{ change.category }}:{{ change.description -}}
-{% endfor %}
+{%- for type_name in ['feature', 'enhancement', 'bugfix'] %}
+{%- for change in changes.changes if change.type == type_name %}
+{%- if loop.first %}
+{%- if type_name == 'feature' %}
+
+### Features
+{%- elif type_name == 'enhancement' %}
+
+### Enhancements
+{%- elif type_name == 'bugfix' %}
+
+### Bug fixes
+{%- endif %}
+{%- endif %}
+* {{ change.description }}
+{%- endfor %}
+{%- endfor %}
+{%- for change in changes.changes if change.type not in ['feature', 'enhancement', 'bugfix'] %}
+{%- if loop.first %}
+
+### Other
+{%- endif %}
+* {{ change.description }}
+{%- endfor %}
 {% endfor %}