Adds directories & email announcement for minor release

[anweshadas]

No description provided.

[mariolenz]

I didn't have a closer look yet, but there are some small things I would change.

[felixfontein]

How about reverting e66ce32 and then merging this, and only after that start with a new PR to improve this? That would IMO hugely improve readability.

[samccann]

Things started to repeat in the different files so I stopped repeating my suggestions. None of these are required for the Tuesday release BTW so no need to rush.

[samccann]

Seems to me the changelogs for Ansible X include the core changelogs. So perhaps these two sentences should be switched to say the collection that opted in blablabla changelog is at .
And then the second sentence states this changelog also includes the core changelogs?

[samccann]

This is a nit/discussion point - I think all collections in the package have a link to the repository on the docsite now. Do we want to switch the wording to point to that instead of galaxy?

[samccann]

When the time comes and the group decides on a better way to phrase the ansible-core dependency, this is another place to update it.

[felixfontein]

I would revert these paragraphs to the original version (https://github.com/ansible-community/ansible-build-data/blob/31da36426e49f598e324d08d3ebdec89a8ba4727/docs/ansible-release-announcement/major-release/announcement-email.md and https://github.com/ansible-community/ansible-build-data/blob/31da36426e49f598e324d08d3ebdec89a8ba4727/docs/ansible-release-announcement/minor-release/announcement-email.md) for now, and then start a separate discussion on how we can improve these.

As for how this could be written IMO:

Ansible X.0.0 includes ansible-core a.b.c as well as a curated set of Ansible collections that provide a vast number of modules and plugins.

Ansible X.0.0 consists of the "ansible" package, which contains the collections, and which depends on the "ansible-core" package.

[anweshadas]

I would revert these paragraphs to the original version (https://github.com/ansible-community/ansible-build-data/blob/31da36426e49f598e324d08d3ebdec89a8ba4727/docs/ansible-release-announcement/major-release/announcement-email.md and https://github.com/ansible-community/ansible-build-data/blob/31da36426e49f598e324d08d3ebdec89a8ba4727/docs/ansible-release-announcement/minor-release/announcement-email.md) for now, and then start a separate discussion on how we can improve these.

I am following this announcement template for 8.3.0 release announcement.

[webknjaz]

Instead of inline, use a code block with proper lexer:

Suggested change

	`$ python3 -m pip install ansible==X.0.0 --user`
	```console
	$ python3 -m pip install ansible==X.0.0
	```

Also I wouldn't steer newbies towards --user. In general, offering a pipx command would be a better idea since it manages per-app venvs automatically.

[webknjaz]

Same sentiment regarding the block highlighting, --user and pipx.

[webknjaz]

RST syntax in Markdown?

[felixfontein]

This is actually MarkDown (CommonMark): https://spec.commonmark.org/0.31.2/#setext-headings

[webknjaz]

Same as above.

[webknjaz]

Only one is the source distribution, the other is called a built distribution.

[felixfontein]

How close / not close are the templates in this PR to what has been used for recent Ansible releases?

[felixfontein]

@anweshadas and me took a quick look at this today, we decided to go through this and ansible-community/antsibull#573 in parallel on Wednesday (during the Ansible collab) and incorporating all parts from here to the antsibull PR so we can close this PR.

If anyone wants text changes afterwards, they can create PR in the antsibull repository after ansible-community/antsibull#573 is merged.

Otherwise we'll never get this done :-)

[felixfontein]

ansible-community/antsibull#579 contains some of the unresolved improvements. Once that's merged I'm planning on closing this. If you want further improvements, please create PRs (or issues with concrete change proposals) for https://github.com/ansible-community/antsibull/.

[gotmax23]

@anweshadas, can we close this now that ansible-community/antsibull#573 has been merged?

[felixfontein]

Yes, I guess we simply forgot to close it :) Let's do it now.

[felixfontein]

Thanks everyone for all the comments, and of course @anweshadas for getting this started! If you have further improvements for the current announcements, please create issues or PRs in the antsibull repositories. Thanks!