Migrate docs to Markdown and add migration documentation for moving t…

…o v2.0.

.gitignore

@@ -54,7 +54,7 @@ coverage.xml
 *.pot
 
 # Sphinx documentation
-docs/_build/
+sphinx/_build/
 
 # OS hidden files
 .DS_Store

CHANGES/template.jinja → .towncrier.md.jinja

@@ -1,31 +1,28 @@
 {% for section, _ in sections.items() %}
-{% set underline = underlines[0] %}{% if section %}{{section}}
-{{ underline * section|length }}{% set underline = underlines[1] %}
-{% endif %}
+{%- if section %}{{section}}{% endif -%}
+
 {% if sections[section] %}
 {% for category, val in definitions.items() if category in sections[section]%}
-{{ definitions[category]['name'] }}
-{{ underline * definitions[category]['name']|length }}
+### {{ definitions[category]['name'] }}
 
 {% if definitions[category]['showcontent'] %}
 {% for text, values in sections[section][category].items() %}
-- {{ text }}
-  (see {{ values|join(',\n  ') }});
+- {{ values|join(', ') }} {{ text }}
 {% endfor %}
 
 {% else %}
-- {{ sections[section][category]['']|join(',\n  ') }};
+- {{ sections[section][category]['']|join(', ') }}
 
 {% endif %}
 {% if sections[section][category]|length == 0 %}
 No significant changes.
 
 {% else %}
 {% endif %}
+
 {% endfor %}
 {% else %}
 No significant changes.
 
-
 {% endif %}
 {% endfor %}