Yes, Markdown is possible when using the Releases API. There I was referring to the default behavior, where Github displays the tag summary as raw text if a formal Github release entry wasn't created for the tag.
To create a formal Github release entry ( https://developer.github.com/v3/repos/releases/#create-a-release), it should be possible to send a POST request to https://api.github.com/repos/apache/beam/releases On Tue, May 19, 2020 at 3:56 PM Brian Hulette <bhule...@google.com> wrote: > > It seems that Github treats the summary as raw text, so you can't really > feed it any complex formatting like Markdown. > > The Helm project you linked seems to be using markdown formatting. > > On Tue, May 19, 2020 at 3:52 PM Julien Phalip <jpha...@gmail.com> wrote: > >> I actually tried that - you can see a quick test here: >> https://github.com/jphalip/beam/releases/tag/v9.9.9 >> >> It seems that Github treats the summary as raw text, so you can't really >> feed it any complex formatting like Markdown. That said, that might be good >> enough if the summary just includes some simple content, which is in fact >> typically the case for email announcements (see example here >> <https://lists.apache.org/thread.html/r1ad72fe524a3fbd67a0cc9f0e171e27eba821daa835063267cffdd95%40%3Cuser.beam.apache.org%3E> >> for the recent 2.20.0 version). In other words, if the tag summary simply >> included a quick note announcing the new version and a link to the release >> notes (e.g. https://beam.apache.org/blog/2020/04/15/beam-2.20.0.html), >> then that'd work pretty well, I think. >> >> >> >> On Tue, May 19, 2020 at 3:39 PM Kyle Weaver <kcwea...@google.com> wrote: >> >>> Including the release notes in the tag seems like a good idea. However, >>> I don't think there is an obvious way to automate the process, since Beam's >>> primary release tool is shell scripts :) and Github tag summaries are a >>> Github feature, not a standard git feature. Would it be sufficient to >>> manually copy the release notes into the tag summary? >>> >>> On Tue, May 19, 2020 at 6:18 PM Julien Phalip <jpha...@gmail.com> wrote: >>> >>>> Hi, >>>> >>>> I'm working with customers who would like to be automatically notified >>>> when new Beam releases come out. They'd also like to see the release notes >>>> so they know what changes were made. >>>> >>>> I know that these announcements are already sent to the user@ and dev@ >>>> mailing lists. However, they're not easy to catch automatically as they're >>>> intermingled with lots of other messages in those lists. >>>> >>>> One possible solution would be to leverage the Beam project's releases Atom >>>> feed <https://github.com/apache/beam/releases.atom> on Github (see >>>> also the web version <https://github.com/apache/beam/releases>). This >>>> allows, for example, to automatically publish a notification in Slack >>>> <https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack> >>>> when a new release comes out. However, the Atom feed only contains the tag >>>> names without any description because the release notes aren't recorded in >>>> Github. >>>> >>>> Do you think that the Beam release process could be extended to call >>>> the Github Releases API >>>> <https://developer.github.com/v3/repos/releases/> to >>>> automatically publish the release notes in Github? >>>> >>>> As an example, see the Helm project's releases page >>>> <https://github.com/helm/helm/releases>, where release notes are >>>> created using a template >>>> <https://github.com/helm/helm/blob/master/scripts/release-notes.sh> >>>> and published with a tool called goreleaser <https://goreleaser.com/>. >>>> >>>> Thank you, >>>> >>>> Julien >>>> >>>