mirror of
https://github.com/docker/docs.git
synced 2026-10-23 18:09:02 +03:00
efa340b605
<!--Delete sections as needed --> ## Description Added back the attribute `external` in the `/reference/compose/secrets` section with a warning that this attribute is only available for Docker Swarm. Additionally, I added a small toy reference example to the section "Defining and using Secrets in compose files" and moved the section outside of the "Examples" section. The reason why I did this is because I noticed the Examples are all runnable steps that showcase concrete usage of secrets, the example I added is just a skeleton/reference to how they should be used in conjunction with `docker secret create...`, not a true able-to-run example like the ones below. I also changed the hyperlink from `/reference/compose-file/legacy-versions.md` to `/reference/compose-file/secrets.md`. A few caveats that I wasn't sure about when writing this: - I'm not sure if using the "[!NOTE]" in the attributes list is the approach maintainers and writers might favor and I can change it accordingly - I'd love to hear feedback on moving "Defining and using secrets in compose files" outside of "Examples" due to my reasoning above Edit: I'm also not opposed to making a fully working example using compose, stack and secrets and putting the section back under `Examples` <!-- Tell us what you did and why --> ## Related issues or tickets #25491 <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>