Have the markup for issue and version defined and generated by the template

[adiroiban]

Right now, the markup for issue and titles is generated by towncrier outside of the template

So for, .MD we have things like this.

underlines = ["", "", ""]
title_format = "## [{version}](https://github.com/twisted/my-project/tree/{version}) - {project_date}"
issue_format = "[#{issue}](https://github.com/twisted/my-project/issues/{issue})"

I think that it would help to simplify this config and allow to fully control the format from the Jinja2 template.

Each issue and title will just recevie the raw data and the Jinja template can decide how to transform it.

---

We could have a default template that add links to version and issues
The configuration will only need to define the links

issue_url = "https://github.com/twisted/my-project/issues/{issue}"
version_url = "https://github.com/twisted/my-project/tree/{version}"

---

If I understand you correctly, I would add a new template file keep_a_changelog.md and then update the documentation to promote the usage as

[tool.towncrier]
directory = "changelog.d"
filename = "CHANGELOG.md"
template = "towncrier:keep_a_changelog.md"
issue_url = "https://github.com/twisted/my-project/issues/{issue}"
version_url = "https://github.com/twisted/my-project/tree/{version}"

[[tool.towncrier.type]]
name = "Security"

[[tool.towncrier.type]]
name = "Removed"

[[tool.towncrier.type]]
name = "Deprecated"

[[tool.towncrier.type]]
name = "Added"

[[tool.towncrier.type]]
name = "Changed"

[[tool.towncrier.type]]
name = "Fixed"

Is that what you had in mind? Is it still necessary to specify the custom types if we request the keep_a_changelog.md template?

Originally posted by @matteosantama in #691

[adiroiban]

@matteosantama

If I understand you correctly, I would add a new template file keep_a_changelog.md and then update the documentation to promote the usage as

I hope that the default Markdown template will have support for links, so we will only need

[tool.towncrier]
directory = "changelog.d"
filename = "CHANGELOG.md"
issue_url = "https://github.com/twisted/my-project/issues/{issue}"
version_url = "https://github.com/twisted/my-project/tree/{version}"

Is that what you had in mind? Is it still necessary to specify the custom types if we request the keep_a_changelog.md template?

For now, the custom types are still required.

The types defintion is required for 2 main reasons:

1. To know how to order the types. For example, security should be at the top
2. To know which types are valid. For example, you only want to use .fixed and prevent developers from using things like .bugfix or .bug or .defect . towncrier check can help make sure only "approved" types are used

I would love to have a simple configuration in which custom types are not required.
I can imagine that we deliver a "standard" set of types and standard order.
As long as you are ok with the standard types, you don't need any extra config.

The goal of the towncrier is allow maximum customziation and not to be opinionated ... and this can make simple things dificult ... but it doesn't mean that this can't be done.

We can still make simple things simple and complicated things possible

This is a discussion for another issue.