docs: update podman driver documentation #11300
Conversation
|
@towe75 here is the source code for the Podman documentation in our website. I copied over the new additions from the You can see a preview of the changes here: https://nomad-4298056vy-hashicorp.vercel.app/docs/drivers/podman |
|
@lgfa29 storing the docs in two places and syncing it manually is tedious and error prone. Having the docs only here imposes some problems when working on a new driver feature in branches. Having it only in the original repo, however, has the downside that we must sync it periodically. Personally i would go for a solution at the ci/build-system/release level. Publishing the website would also reformat/embed the documentation from a number of external driver repositories (e.g. latest release per driver). It's fine IMO to require driver authors to inherit some strict documentation format rules or a specific repo layout (e.g. docs/ folder). I've worked long enough on poly-repos to immediately recognize the underlying pattern. Better to spend a few hours on the ci server. |
|
Yeah..pulling docs from external repos has been on mind for a while. I know that Packer does it and Terraform also has a way to re-build the registry based on the provider I will need to look into how they work and adapt it into the Nomad website. In the meantime, I will merge this PR and sync things ad-hoc. |
Not at all, I actually forgot to tag you until very recently 😅 |
|
I'm going to lock this pull request because it has been closed for 120 days ⏳. This helps our maintainers find and focus on the active contributions. |
Update Podman task driver documentation based on latest repo's README.