1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00

19 Commits

Author SHA1 Message Date
David Karlsson
3f5e702096 docs: remove experimental framing from cloud sandboxes (#26335)
## Summary

Remove experimental badges and notices for the Cloud Sandboxes CLI, API,
and SDK, including the API reference card and CLI release notes.
Preserve the Docker Agentic Platform experimental status, the
subscription requirement, and feature-specific experimental warnings.

@netlify /ai/sandboxes/cloud/

Generated by Codex

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-12 16:09:12 +02:00
David Karlsson
bed22bda81 docs: Cloud Sandboxes API and SDK (#26168)
## Description

Add an experimental Sandboxes API and SDK section alongside Docker
Sandboxes under AI and agents, at `/ai/sandboxes-api/`. Cover
installation of `@docker/sandboxes`, browser and PAT authentication, and
a TypeScript walkthrough that launches the shell kit, runs a command,
and deletes the sandbox. Explain kits and image choices with examples,
along with compute sizes, quotas, permissions, resource lifecycle,
errors, and retries. Link subscription setup and billing to the shared
Docker Agentic Platform guide. Preserve the previous
`/ai/sandboxes/api/` URLs with redirects.

Uses the shared Docker Agentic Platform documentation merged in #26142.
Sibling to #26158, which introduces CLI-side Cloud Sandboxes
documentation.

Include 36 SDK cookbook recipes at `/ai/sandboxes-api/cookbook/` and the
public REST API reference at `/reference/api/sandboxes/`. Import the
generated export from `docker/sbx-api` commit `60d79c1d` (source
`1a7f4026`). Overview and installation remain maintained here. The
reference uses the shared API renderer from main, with separate
operation and schema pages, streaming and WebSocket details, and a
downloadable OpenAPI spec. An API reference link appears in the API/SDK
sidebar. A pinned manifest and import script provide the basis for later
release automation.

Examples are optional in the shared renderer; supplied examples still
have to pass schema validation. Requests without body examples use a
request-body file with instructions to prepare it. The import copies all
selected recipes and the OpenAPI specification byte for byte from the
corrected upstream export, without patches or link rewrites. The broken
naming recipe remains temporarily excluded.

This remains a draft pending validation against the published npm SDK.
The imported cookbook contains the TypeScript-only guidance, five-minute
request deadlines, kit-readiness explanation, active-policy status
requirement, and snapshot-deletion and lifetime-renewal restrictions.

Validation: scoped Markdown and Vale checks, full Hugo build, rendered
navigation, redirects, and internal links, and TypeScript type-checking
against the generated public SDK from `docker/sbx-api` commit
`68f214b9`. Import validation also covers all 60 REST operations and 188
schema definitions, 1,198 imported-page links and anchors,
desktop/mobile rendering, Markdown output, spec delivery, and a repeat
import. The shared renderer tests, strict generation for all five APIs
(zero diagnostics), full Hugo build, and verification of 453
HTML/Markdown page pairs and API links pass. No live sandbox execution.
The corrected export passes strict generation for all five APIs with
zero diagnostics, scoped Markdown/Vale lint, a full Hugo build, and
verification of 453 HTML/Markdown page pairs and API links. A repeat
import produces identical files. The spec update changes examples only;
schemas and operations are unchanged.

@netlify /ai/sandboxes-api/

Generated by Codex

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-09-24 18:06:30 +02:00
David Karlsson
ee71c80562 chore: migrate icons from Material Symbols to Heroicons
Replaces @material-symbols/svg-400 (5.5 MB) with heroicons (488 KB) — an
11x reduction in icon asset size. Heroicons uses a single consistent
distribution format (24px solid SVGs, fill="currentColor") eliminating
the need for the separate utils/svg.html partial, the icon-svg-stroke CSS
utility, and the dual-path resolution logic in icon.html.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-18 12:05:54 +02:00
Vincent DAMERY
c69c0b53dd [docker-hub-api] add list namespace repositories endpoint (#22934)
<!--Delete sections as needed -->

## Description

- Add "new" list repositories in a given namespace endpoint : `GET
/v2/namespaces/{namespace}/repositories`

---
After the comments from @thaJeztah 
- Split DVP Data API and Docker Hub API for better visiblity
- Standardize sub entries in the side menu : Changelog, Deprecated and
OpenAPI
- Deprecated is now a table like in
https://docs.docker.com/engine/deprecated/

## Related issues or tickets

- https://github.com/docker/hub-feedback/issues/2357

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [x] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-15 08:46:14 -07:00
Craig Osterhout
726b57a2ac registry: add reference (#22497)
<!--Delete sections as needed -->

## Description

Re-add registry reference from point in time of deletion at
https://github.com/docker/docs/pull/18390, not upstream.


https://deploy-preview-22497--docsdocker.netlify.app/reference/api/registry/latest/

https://deploy-preview-22497--docsdocker.netlify.app/reference/api/registry/auth/

## Related issues or tickets

ENGDOCS-2577

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
Co-authored-by: sheltongraves <148902861+sheltongraves@users.noreply.github.com>
Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
2025-05-23 10:34:20 -07:00
David Karlsson
dd294db10b hugo: add main nav icons and fix mobile rendering
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 17:50:29 +02:00
David Karlsson
4443d3640a hugo: update layout architecture
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-16 14:43:05 +02:00
David Karlsson
07a053763f compose: use plugin base cmd as cli overview
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 15:45:42 +02:00
David Karlsson
2835a7c051 reference: update link to docker cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 13:54:03 +02:00
David Karlsson
fe282cdb17 reference: remove registry (distribution) api link
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 13:52:27 +02:00
David Karlsson
2018844f1e chore: move engine API to /reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 13:24:05 +02:00
David Karlsson
d969391357 chore: move glossary to /reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 13:24:05 +02:00
David Karlsson
eb37a7891e chore: move hub API to /reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-22 13:24:05 +02:00
Allie Sadler
52b3d97da7 ENGDOCS-2184 (#20641)
* ENGDOCS-2184

* fix more links

* remove numbers from file names

* final link fix

* this is really the last fix
2024-08-19 11:45:34 +01:00
David Karlsson
8a4749bd22 redirect: remove redirects for retired commands
retired commands should not redirect to unrelated pages just to avoid
404

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-08-14 09:40:11 +02:00
David Karlsson
b3620f8204 chore: remove duplicate content paths
Duplicate aliases means multiple pages will attempt to redirect the same
URL

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-06-07 09:19:53 +02:00
Allie Sadler
6ee0567ce7 ENGDOCS-2084 (#19940) 2024-05-02 12:54:23 +01:00
David Karlsson
ff25d689ed reference: remove links to distribution specs
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-04-11 17:50:29 +02:00
David Karlsson
f3b44a4476 cli: change reference docs url paths
Moves the reference documentation to a new subpath, from /engine/ to /reference/
2024-02-21 10:25:53 +01:00