**Overview of changes:**
- Runner bumped from Ubuntu 22.04 => 24.04
- Revised inline documentation for maintainers.
- The output of `build-docs.sh` is now grouped in the steps action log, and now hides the noise from pulling the image via `docker run`.
- Removed the separate `tar` steps with ZSTD as there is only a directory to archive with recent changes to this workflow. The `upload` + `download` actions are sufficient.
- The `workflow_run` job has had the PR context restore step extracted to a separate job to minimize noise.
- `actions-netlify` is still effectively the same functionality.
- `github-token` is no longer configured as it doesn't appear needed with the functions disabled.
- Opt-out of the GH deployments feature which is not needed.
This is a better choice to advise for `UIDMap` value.
Additionally provide further information for the user to understand this setting better, along with the syntax used.
Systemd specifier admonition added for better communicating the usage when user is not familiar.
These admonitions better highlight the distinction between Podman and systemd syntax/features.
- Revised the inline commentary.
- Volume base path adjusted. Timezone volume swapped with equivalent feature supported by podman.
- Container name and volume paths using `%N` systemd specifier to refer to the config file name without the `.container` extension.
- Added note about interface name in rootless context.
- Better document differences between `pasta` and `slip4netns`.
- Initial revision on Quadlet example section:
- `network-online.target` wants/after requirements are implicit. No need to add this.
- `Network=pasta` not required from Podman 5.0.
- `HostName` should match config elsewhere in docs as `mail.example.com`.
- Fixes the `if` condition that was recently adjusted.
- Better documents concerns for maintainers to be aware of.
- Reference the `pull_requests` ENV at runtime instead of embedding content into the script via GHA context expression. This is a better practice which prevent exploits from untrusted inputs (_notably for context objects which might introduce new fields in future_).
---------
Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com>
Generate systemd is deprecated and Quadlets are now used. I have spent some time getting Quadlet to work, so I added some findings to the documentation. It is my first time contributing to documentation, so excuse my English if it comes across a bit rambly.
I have only added information, and have not removed any. However, generate-systemd is now deprecated and slirp4netns is out in favour of pasta. Pasta in particular is a lot easier to configure, but is still complicated to include into a docker-compose, which I do not use anymore.
Using podlet you can also translate a docker-compose to a Quadlet. Quadlets themselves behave a lot like individual compose files, but are managed by systemd.
