feat(template): add description to markdown template

aar_doc/templates/markdown.j2

@@ -24,6 +24,16 @@ Tags: {{ metadata.galaxy_info.galaxy_tags | join(', ') }}
 
 {{ argument_specs[entrypoint].short_description }}
 
+{% if "description" in argument_specs[entrypoint] %}
+{%- if argument_specs[entrypoint].description is string -%}
+{{ argument_specs[entrypoint].description }}
+{% else %}
+{%- for line in argument_specs[entrypoint].description -%}
+{{ line }}
+{% endfor -%}
+{% endif -%}
+{% endif -%}
+
 {% if entrypoint_options[entrypoint] %}
 {%- set path, options=entrypoint_options[entrypoint][0] -%}
 |Option|Description|Type|Required|Default|

tests/fixtures/roles/extended/README.md

@@ -20,6 +20,12 @@ Tags: ansible, docs
 
 The main entrypoint for the extended role
 
+A longer description of the entrypoint.
+
+Reaching multiple lines.
+
+This contains the various parameters one can give in argument_specs that do not get tested below.
+
 |Option|Description|Type|Required|Default|
 |---|---|---|---|---|
 | name | This one contains option-name, which should override the name given for the option. | str | no |  |

tests/fixtures/roles/meta_main_yaml/README.md

@@ -17,6 +17,12 @@ Test role with a minimum amount of metadata
 
 The main entrypoint for the extended role
 
+A longer description of the entrypoint.
+
+Reaching multiple lines.
+
+This contains the various parameters one can give in argument_specs that do not get tested below.
+
 |Option|Description|Type|Required|Default|
 |---|---|---|---|---|
 | name | This one contains option-name, which should override the name given for the option. | str | no |  |