docs: compose logs: add links for since/until flag descriptions by thaJeztah · Pull Request #13806 · docker/compose

thaJeztah · 2026-05-22T12:01:32Z

alternative to docs: compose logs update #13803

Link to the corresponding docker container logs equivalents, which contain more details on the accepted formats and use.

The container logs documentation still needs some updates to provide per-flag sections, so follow-ups can be made once those are done.

What I did

Related issue

(not mandatory) A picture of a cute animal, if possible in relation to what you did

thaJeztah · 2026-05-22T12:03:09Z

 	flags.BoolVarP(&opts.follow, "follow", "f", false, "Follow log output")
 	flags.IntVar(&opts.index, "index", 0, "index of the container if service has multiple replicas")
 	flags.StringVar(&opts.since, "since", "", "Show logs since timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes)")
+	flags.SetAnnotation("since", annotation.ExternalURL, []string{"https://docs.docker.com/reference/cli/docker/container/logs/"})


no anchor for this one yet

docker-agent

Assessment: 🟢 APPROVE

This is a clean, minimal documentation PR that adds ExternalURL annotations to the --since and --until flags in compose logs. The Go source change, the generated Markdown table (compose_logs.md), and the generated YAML (docker_compose_logs.yaml) are all mutually consistent.

One minor observation (informational, not blocking): --until links directly to the #until anchor (https://docs.docker.com/reference/cli/docker/container/logs/#until), while --since links to the root page without a fragment. The PR description acknowledges that the Docker container logs docs still need per-flag sections, so this asymmetry is intentional and acceptable for now — --since simply doesn't have a dedicated anchor target yet.

No functional issues found in the changed code.

Copilot

Pull request overview

Adds cross-references for docker compose logs --since/--until flags to the equivalent docker container logs documentation, so users can find detailed accepted timestamp/relative formats.

Changes:

Add details_url entries for since and until in the reference YAML.
Add external documentation links for --since and --until in the generated compose_logs.md options table.
Annotate the Cobra flags for since/until with external URLs to drive doc generation.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
docs/reference/docker_compose_logs.yaml	Adds `details_url` metadata for `since`/`until` options to point at container logs docs.
docs/reference/compose_logs.md	Updates the options table to link `--since`/`--until` to external docs pages.
cmd/compose/logs.go	Adds external URL annotations to `since`/`until` flags for documentation generation.

thaJeztah · 2026-05-22T12:13:59Z

+	flags.SetAnnotation("since", annotation.ExternalURL, []string{"https://docs.docker.com/reference/cli/docker/container/logs/"})
 	flags.StringVar(&opts.until, "until", "", "Show logs before a timestamp (e.g. 2013-01-02T13:23:37Z) or relative (e.g. 42m for 42 minutes)")
+	flags.SetAnnotation("until", annotation.ExternalURL, []string{"https://docs.docker.com/reference/cli/docker/container/logs/#until"})


Yeah, added the "nolint"; still need to convince the pflag maintainers / finish my PR there;

feat: FlagSet: add MustSetAnnotation method spf13/pflag#458

thaJeztah · 2026-05-22T12:10:19Z

Opened docker/cli#7003 in the CLI

Link to the corresponding `docker container logs` equivalents, which contain more details on the accepted formats and use. The container logs documentation still needs some updates to provide per-flag sections, so follow-ups can be made once those are done. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

codecov · 2026-05-22T12:24:13Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

This MR contains the following updates: | Package | Update | Change | |---|---|---| | [docker/compose](https://github.com/docker/compose) | minor | `v5.1.4` → `v5.3.1` | MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot). **Proposed changes to behavior should be submitted there as MRs.** --- ### Release Notes <details> <summary>docker/compose (docker/compose)</summary> ### [`v5.3.1`](https://github.com/docker/compose/releases/tag/v5.3.1) [Compare Source](docker/compose@v5.3.0...v5.3.1) #### What's Changed ##### 🔧 Internal - Ci: add concurrency group to pr-review-trigger to prevent duplicate reviews by [@derekmisler](https://github.com/derekmisler) in [#13890](docker/compose#13890) - Fix grammar in Attestations field comment by [@blackflytech](https://github.com/blackflytech) in [#13891](docker/compose#13891) - Ci: remove unused desktop-edge-test workflow by [@thaJeztah](https://github.com/thaJeztah) in [#13897](docker/compose#13897) - Ci: zizmor workflow by [@crazy-max](https://github.com/crazy-max) in [#13901](docker/compose#13901) - Ci: fix docs-upstream workflow by [@crazy-max](https://github.com/crazy-max) in [#13912](docker/compose#13912) - CODEOWNERS: add compose-reviewers by [@thaJeztah](https://github.com/thaJeztah) in [#13913](docker/compose#13913) - Ci: harden GitHub Actions workflows by [@glours](https://github.com/glours) in [#13896](docker/compose#13896) - GHA: dependabot: group docker/\* actions updates by [@thaJeztah](https://github.com/thaJeztah) in [#13914](docker/compose#13914) ##### ⚙️ Dependencies - Build(deps): bump github.com/moby/buildkit from `0.31.0` to `0.31.1` by [@dependabot](https://github.com/dependabot)\[bot] in [#13892](docker/compose#13892) - Build(deps): bump github.com/moby/sys/user to `v0.4.1` by [@thaJeztah](https://github.com/thaJeztah) in [#13893](docker/compose#13893) - Build(deps): bump go.yaml.in/yaml/v4 from `4.0.0-rc.4` to `4.0.0-rc.6` by [@dependabot](https://github.com/dependabot)\[bot] in [#13876](docker/compose#13876) - Build(deps): bump github.com/docker/cli from `29.6.0+incompatible` to `29.6.1+incompatible` by [@dependabot](https://github.com/dependabot)\[bot] in [#13895](docker/compose#13895) - Build(deps): bump actions/stale from `10.2.0` to `10.3.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13902](docker/compose#13902) - Build(deps): bump the docker-actions group with 3 updates by [@dependabot](https://github.com/dependabot)\[bot] in [#13916](docker/compose#13916) - Build(deps): bump actions/upload-artifact from `7.0.0` to `7.0.1` by [@dependabot](https://github.com/dependabot)\[bot] in [#13908](docker/compose#13908) - Build(deps): bump actions/setup-go from `6.3.0` to `6.5.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13907](docker/compose#13907) - Build(deps): bump test-summary/action from `2.4` to `2.6` by [@dependabot](https://github.com/dependabot)\[bot] in [#13903](docker/compose#13903) - Build(deps): bump mxschmitt/action-tmate from `3.23` to `3.24` by [@dependabot](https://github.com/dependabot)\[bot] in [#13910](docker/compose#13910) - Build(deps): bump codecov/codecov-action from `5.5.3` to `7.0.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13904](docker/compose#13904) - Build(deps): bump github/codeql-action/upload-sarif from `3.36.3` to `4.36.2` by [@dependabot](https://github.com/dependabot)\[bot] in [#13917](docker/compose#13917) - Build(deps): bump actions/checkout from `6.0.2` to `7.0.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13911](docker/compose#13911) #### New Contributors - [@blackflytech](https://github.com/blackflytech) made their first contribution in [#13891](docker/compose#13891) **Full Changelog**: <docker/compose@v5.3.0...v5.3.1> ### [`v5.3.0`](https://github.com/docker/compose/releases/tag/v5.3.0) [Compare Source](docker/compose@v5.2.0...v5.3.0) #### What's Changed > ℹ️ This release introduces native support for init containers. ##### ✨ Improvements - Pre start init containers by [@glours](https://github.com/glours) in [#13862](docker/compose#13862) ##### 🐛 Fixes - Fix(oci): route authorizer token fetches through provided transport by [@glours](https://github.com/glours) in [#13873](docker/compose#13873) - Fix(run): scope Running events to project.Services by [@glours](https://github.com/glours) in [#13883](docker/compose#13883) ##### 🔧 Internal - Chore: migrate cagent-action to docker-agent-action (v2.0.0) by [@docker-agent](https://github.com/docker-agent) in [#13869](docker/compose#13869) - Chore: migrate to docker-agent-action v2.0.1 by [@docker-agent](https://github.com/docker-agent) in [#13872](docker/compose#13872) - Fix(reconcile): hash resolved service refs to match executor by [@glours](https://github.com/glours) in [#13880](docker/compose#13880) - Fix(compose/port): show private port in portNotFoundError message by [@vmphase](https://github.com/vmphase) in [#13875](docker/compose#13875) - Fix(run): normalize --no-TTY flag to --no-tty by [@nickjj](https://github.com/nickjj) in [#13885](docker/compose#13885) ##### ⚙️ Dependencies - Bump compose-go to version v2.13.0 by [@glours](https://github.com/glours) in [#13886](docker/compose#13886) #### New Contributors - [@docker-agent](https://github.com/docker-agent) made their first contribution in [#13869](docker/compose#13869) - [@vmphase](https://github.com/vmphase) made their first contribution in [#13875](docker/compose#13875) - [@nickjj](https://github.com/nickjj) made their first contribution in [#13885](docker/compose#13885) **Full Changelog**: <docker/compose@v5.2.0...v5.3.0> ### [`v5.2.0`](https://github.com/docker/compose/releases/tag/v5.2.0) [Compare Source](docker/compose@v5.1.4...v5.2.0) #### What's Changed > ℹ️ This version introduces a new reconciliation algorithm between the observed state and the expected state. > > If you experience any issues with a Compose workload that was previously working, please open an issue. ##### ✨ Improvements - Reconciliation plan by [@ndeloof](https://github.com/ndeloof) & [@glours](https://github.com/glours) in [#13830](docker/compose#13830) - Add `rawsetenv` message type for provider plugins by [@rajyan](https://github.com/rajyan) in [#13742](docker/compose#13742) ##### 🐛 Fixes - Fix(build): skip remote URL contexts from bake fs.read allowlist by [@ndeloof](https://github.com/ndeloof) in [#13816](docker/compose#13816) - Skip validation when extracting config variables by [@scarab-systems](https://github.com/scarab-systems) in [#13831](docker/compose#13831) - Fix(progress): probe stderr (not stdout) for TTY auto-detection by [@glours](https://github.com/glours) in [#13837](docker/compose#13837) - Fix(publish): honor env\_file required: false for missing files by [@Ijtihed](https://github.com/Ijtihed) in [#13848](docker/compose#13848) ##### 🔧 Internal - Docs: compose logs: add links for since/until flag descriptions by [@thaJeztah](https://github.com/thaJeztah) in [#13806](docker/compose#13806) - Ci: add Dependabot cooldown ([`2026060`](docker/compose@20260603)-170456) by [@securityeng-bot](https://github.com/securityeng-bot)\[bot] in [#13820](docker/compose#13820) - Docs(CLAUDE.md): note that commits must be signed off (DCO) by [@ndeloof](https://github.com/ndeloof) in [#13817](docker/compose#13817) - Refactor: replace Split in loops with more efficient SplitSeq and replace HasPrefix+TrimPrefix with CutPrefix by [@caltechustc](https://github.com/caltechustc) in [#13810](docker/compose#13810) - Chore: fix some comments to improve readability by [@solunolab](https://github.com/solunolab) in [#13823](docker/compose#13823) - GHA: update docs-upstream to pin workflows by sha by [@thaJeztah](https://github.com/thaJeztah) in [#13834](docker/compose#13834) - Docs: compose logs: add more links for flag descriptions by [@thaJeztah](https://github.com/thaJeztah) in [#13833](docker/compose#13833) - Fix/progress tty line overflow 13595 by [@glours](https://github.com/glours) in [#13840](docker/compose#13840) - Fix(publish): bypass Docker Desktop proxy for loopback registries by [@ptrdom](https://github.com/ptrdom) in [#13825](docker/compose#13825) - Watch: do not rebuild depends\_on services on file change by [@ndeloof](https://github.com/ndeloof) in [#13856](docker/compose#13856) - pkg/e2e: fix malformed JWT in fixtures by [@thaJeztah](https://github.com/thaJeztah) in [#13857](docker/compose#13857) - pkg/e2e: drop unused run param from getEnv by [@glours](https://github.com/glours) in [#13867](docker/compose#13867) - Docs: `ps --format json` outputs JSON Lines, not a JSON array by [@glours](https://github.com/glours) in [#13868](docker/compose#13868) ##### ⚙️ Dependencies - Build(deps): bump github.com/docker/cli from `29.5.1+incompatible` to `29.5.2+incompatible` by [@dependabot](https://github.com/dependabot)\[bot] in [#13802](docker/compose#13802) - Update to go `1.26.4` by [@thaJeztah](https://github.com/thaJeztah) in [#13828](docker/compose#13828) - Chore(deps): github.com/containerd/typeurl/v2 `v2.3.0` by [@thaJeztah](https://github.com/thaJeztah) in [#13829](docker/compose#13829) - Build(deps): bump golang.org/x/sync from `0.20.0` to `0.21.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13838](docker/compose#13838) - Chore(deps): github.com/docker/cli `v29.5.3`, github.com/docker/buildx `v0.34.1`, buildkit `v0.30.0` by [@thaJeztah](https://github.com/thaJeztah) in [#13841](docker/compose#13841) - Build(deps): bump golang.org/x/sys from `0.45.0` to `0.46.0` by [@dependabot](https://github.com/dependabot)\[bot] in [#13832](docker/compose#13832) - Chore(deps): golang.org/x/crypto `v0.53.0` by [@thaJeztah](https://github.com/thaJeztah) in [#13844](docker/compose#13844) - Build(deps): bump github.com/containerd/containerd/v2 from `2.2.3` to `2.2.4` in the go\_modules group across 1 directory by [@dependabot](https://github.com/dependabot)\[bot] in [#13804](docker/compose#13804) - Chore(deps): bump github.com/containerd/containerd/v2 to `v2.2.5` by [@thaJeztah](https://github.com/thaJeztah) in [#13855](docker/compose#13855) - Chore(deps): bump github.com/golang-jwt/jwt/v5 to `v5.3.1` by [@thaJeztah](https://github.com/thaJeztah) in [#13847](docker/compose#13847) - Chore(deps): github.com/docker/cli `v29.6.0`, github.com/docker/buildx `v0.35.0`, buildkit `v0.31.0` by [@thaJeztah](https://github.com/thaJeztah) in [#13842](docker/compose#13842) - Bump compose-go to version `v2.12.1` by [@glours](https://github.com/glours) in [#13865](docker/compose#13865) #### New Contributors - [@securityeng-bot](https://github.com/securityeng-bot)\[bot] made their first contribution in [#13820](docker/compose#13820) - [@caltechustc](https://github.com/caltechustc) made their first contribution in [#13810](docker/compose#13810) - [@solunolab](https://github.com/solunolab) made their first contribution in [#13823](docker/compose#13823) - [@scarab-systems](https://github.com/scarab-systems) made their first contribution in [#13831](docker/compose#13831) - [@ptrdom](https://github.com/ptrdom) made their first contribution in [#13825](docker/compose#13825) - [@rajyan](https://github.com/rajyan) made their first contribution in [#13742](docker/compose#13742) - [@Ijtihed](https://github.com/Ijtihed) made their first contribution in [#13848](docker/compose#13848) **Full Changelog**: <docker/compose@v5.1.4...v5.2.0> </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this MR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this MR, check this box --- This MR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).

Copilot AI review requested due to automatic review settings May 22, 2026 12:01

thaJeztah requested a review from a team as a code owner May 22, 2026 12:01

thaJeztah requested review from glours and ndeloof May 22, 2026 12:01

Copilot started reviewing on behalf of thaJeztah May 22, 2026 12:02 View session

thaJeztah mentioned this pull request May 22, 2026

docs: compose logs update #13803

Closed

thaJeztah commented May 22, 2026

View reviewed changes

docker-agent Bot reviewed May 22, 2026

View reviewed changes

Copilot AI reviewed May 22, 2026

View reviewed changes

thaJeztah mentioned this pull request May 22, 2026

docs: container logs: add headers for flags docker/cli#7003

Merged

thaJeztah force-pushed the logs_links branch from 8eea58a to 24c4e89 Compare May 22, 2026 12:12

aevesdocker approved these changes May 26, 2026

View reviewed changes

glours approved these changes May 26, 2026

View reviewed changes

glours merged commit 7eeb7de into docker:main May 26, 2026
43 checks passed

aevesdocker mentioned this pull request May 26, 2026

Document what format docker compose logs --since takes docker/docs#20712

Closed

1 task

thaJeztah mentioned this pull request Jun 9, 2026

docs: compose logs: add more links for flag descriptions #13833

Merged

BrewTestBot mentioned this pull request Jun 23, 2026

docker-compose 5.2.0 Homebrew/homebrew-core#289498

Merged

rancherbot mentioned this pull request Jun 24, 2026

rddepman: bump dockerCompose from 5.1.4 to 5.2.0 rancher-sandbox/rancher-desktop#10513

Merged

r-desktop-workflow-from-workflow Bot mentioned this pull request Jul 8, 2026

rddepman: bump dockerCompose from 5.1.4 to 5.3.1 rancher-sandbox/rancher-desktop-2#540

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: compose logs: add links for since/until flag descriptions#13806

docs: compose logs: add links for since/until flag descriptions#13806
glours merged 1 commit into
docker:mainfrom
thaJeztah:logs_links

thaJeztah commented May 22, 2026

Uh oh!

thaJeztah May 22, 2026

Uh oh!

docker-agent Bot left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

thaJeztah May 22, 2026

Uh oh!

thaJeztah commented May 22, 2026

Uh oh!

codecov Bot commented May 22, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

thaJeztah commented May 22, 2026

Uh oh!

thaJeztah May 22, 2026

Choose a reason for hiding this comment

Uh oh!

docker-agent Bot left a comment

Choose a reason for hiding this comment

Assessment: 🟢 APPROVE

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

thaJeztah May 22, 2026

Choose a reason for hiding this comment

Uh oh!

thaJeztah commented May 22, 2026

Uh oh!

codecov Bot commented May 22, 2026

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants