Create an extension to generate a changelog about asciidoctor-extensions-lab HOT 4 OPEN

This would be insanely useful.

Here are a few ideas of what to include:

Per tag:

• version number
• release date
• release author

Per item:

• summary
• issue number(s)
• commit author(s)
• category

Summary:

• link to full diff
• link to milestone in issue tracker
• link to git tag

The hardest part is the category. This is where some conventions in the project would help. One way is to lookup the referenced issue and grab its label(s). Another idea is to include a category label in the commit messages. I picked up this idea from https://www.youtube.com/watch?v=m0_C2cfM9IM.

from asciidoctor-extensions-lab.

Perhaps the target should be the tag and the service/source part of the attribute list.

changelog::v1.5.3..v1.5.4[source=git]

or simply

changelog::v1.5.3..v1.5.4[git]

or, perhaps, the version range should be implied (going one back)

changelog::v1.5.4[git]

I might even argue the case that the service/source should be part of the macro name:

git-changelog::v1.5.4[]

from asciidoctor-extensions-lab.

Thanks Dan for sharing your ideas, lot of great stuff 😄

the version range should be implied (going one back)

This can be tricky because it depends on project's conventions.

issue number(s)

We could also automatically add a link on the issue tracker but again it depends on project's conventions.

from asciidoctor-extensions-lab.

from asciidoctor-extensions-lab.