Simon Josefsson [2025-11-29 18:38 +0100] wrote: > "Basil L. Contovounesios" <[email protected]> writes: > >> I like to format each individual piece of news as an unordered list >> item, which affords decent flexibility in formatting. Assuming >> CommonMark[0], for example: > > Suggestions like that is what I think would be useful in the manual > eventually. We should consider other existing running practice in this > area, it seems some GitHub release bots (whatever we may think about > them) follow some release announcement patterns that may be useful to > get inspiration from.
Could you post some links to these? > Btw, it seems NEWS.org and README.org is another markdown-like format > that is supported -- see for example > https://github.com/djcb/mu/tree/master -- and maybe we want to consider > that too eventually. I also recall *.adoc being supported. Maybe let's > get some releases out using NEWS.md first so we know that works. Yes, it is only natural that people use different formats, whether out of personal preference or for consistency with the rest of their project's conventions. IIRC GitHub and GitLab accept several formats, whereas e.g. SourceHut is stricter in accepting only plaintext or Markdown: https://man.sr.ht/git.sr.ht/#readme-and-license-files I was wary of mentioning alternatives to Markdown: - partly because they (unlike .md) have no precedent in GNU AFAIK; - partly because Markdown anecdotally seems the most universal; and - partly in fear of startling others, or bikeshedding. > I've not noticed any other *.md related > problem, but maybe something happens when I actually try to push things > out. ...tick tick tick... >>> What is a good improvement here? I suppose symlinks in tarballs aren't >>> portable? >> >> Can this limitation be worked around in dist-hook? > > Maybe -- but why do we have that limitation in the first place? > > InetUtils is even using the 'tar-ustar' format. > > On what systems will a symlink in a tarball lead to a failure? I don't know (I have little experience with most Gnulib portability targets), but if I were pressed to guess I would say Windows. Does anyone else know? Thanks, -- Basil
