Commit Graph

470 Commits

Author SHA1 Message Date
Craig Osterhout
4a3f9e3cbe homepage: update download component (#23978)
<!--Delete sections as needed -->

## Description

This might be a my computer thing (because my computer probably isn't
the fastest), but the component often flickers on load.

- ~Removed x-collapse and~ added x-cloak to prevent the drop-down from
appearing expanded before the js loads.
- Changed the button text to static, so it's not waiting for the OS
detection to load.

## Related issues or tickets

ENGDOCS-3149

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-14 11:50:05 -08:00
David Karlsson
50f7d86aef Merge pull request #23960 from dvdksn/improve-markdown-rendering
improve markdown rendering
2026-01-13 16:54:52 +01:00
David Karlsson
04b50acd16 site(gordon): shorten footer message
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 16:17:38 +01:00
David Karlsson
33f0ec928c site(gordon): update example questions
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 15:37:59 +01:00
David Karlsson
672eac9241 site(gordon): add link to feedback issue
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:28:17 +01:00
David Karlsson
26e697d482 site(gordon): add turn limit (10 messages)
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
b0e9949db2 site(gordon): get qa ID from stream chunk
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
4455ac2821 site(gordon): always show message actions, add error handling
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
3a25078dba site(gordon): add y padding for response in loading state
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
e92886454d site(gordon): make page context switch prettier
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
eb4bb34edf site(gordon): update message window styles
- Increase chat panel width from 70ch to 80ch
- Update user message background colors for better contrast
- Add prose styling to messages for consistent typography
- Simplify message rendering template structure

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
a9651d19db site(gordon): configure hostname with HUGO_USE_LOCAL_GORDON
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
f54f6db10c site(gordon): show error message when rate limited
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
d3a595ef6a site: use gordon for ask ai
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-13 12:21:28 +01:00
David Karlsson
23a6fde9cb site: render page info dropdown on cli pages
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:45:33 +01:00
David Karlsson
8c05ef70b8 hugo: render markdown for api/cli reference pages
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:42:05 +01:00
David Karlsson
aa10ed9784 hugo: improve metadata rendering for markdown output
Render title and related pages as front matter

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:17:32 +01:00
David Karlsson
8e88adb4ad site: improve the page options menu
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:17:32 +01:00
David Karlsson
b45c1b846e site: update page opts menu ref to markdown pages
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:11:19 +01:00
David Karlsson
b3a1fe27ba site: add rel link to markdown output
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 15:11:19 +01:00
David Karlsson
b619ed27d3 hugo: improve shortcode rendering for markdown output
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-12 13:02:07 +01:00
David Karlsson
9a56ba3db0 site: add dd download links to homepage
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-09 17:44:07 +01:00
Allie Sadler
95132e4677 Removes DD: RSS feed (#23943) 2026-01-08 09:23:27 -08:00
Sebastiaan van Stijn
67c1e98f0b api: include alternate link for swagger / OpenAPI spec
The API docs are generated dynamically, which prevents them from being
crawled / indexed. Provide a link to the swagger / OpenAPI spec that's
used to generate the page, so that that content can be used as alternative.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2026-01-08 16:36:09 +01:00
David Karlsson
8725611e05 Merge pull request #23812 from dvdksn/geo
site: improve schema.org json-ld markup
2026-01-07 10:16:09 +01:00
Craig Osterhout
b10a462f9f rename api layout (#23928)
<!--Delete sections as needed -->

## Description

Rename API template



https://deploy-preview-23928--docsdocker.netlify.app/reference/api/engine/version/v1.52/

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-05 16:40:38 +00:00
David Karlsson
cf5fa9aeda hugo: update reference to internal template
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-05 08:34:34 +01:00
Craig Osterhout
9681433916 component: adjust grid resizing
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-12-19 12:39:59 -08:00
David Karlsson
599393423f dhi: use attribute for tier, remove badge shortcode from heading
Create a 'tier' attribute for headings and render it semantically

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-17 14:07:35 +01:00
David Karlsson
824a2d5366 site: add dhi migrations/examples as featured guides
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-17 14:07:35 +01:00
David Karlsson
d7f4273ec2 hugo: add redirect page type
For redirecting to another page

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-17 14:07:35 +01:00
David Karlsson
fa4652c9ae site: add dhi free to landing page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-17 14:07:35 +01:00
Craig Osterhout
3b63ec257d dhi: introducing dhi free
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-12-17 14:07:03 +01:00
David Karlsson
4cc579f17b site: improve header buttons, remove support link
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-12 17:43:34 +01:00
David Karlsson
1e722fdad5 site: improve schema.org json-ld markup
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-05 13:46:40 +01:00
Craig Osterhout
ac68e447ff hub: add base url to api paths (#22870)
<!--Delete sections as needed -->

## Description

Display the base url specifically for Hub API and Registry API docs. 

Is this enough, or do we also need to write something about it in the
description at the top?


![image](https://github.com/user-attachments/assets/666a4605-c131-4593-8a67-132481785a3e)


## Related issues or tickets

ENGDOCS-2748

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-11-24 14:30:48 -08:00
Craig Osterhout
9d943869af components: add deprecated badge (#23744)
<!--Delete sections as needed -->

## Description

Added gray color for deprecated badge.
Updated contribution guide for usage

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-19 09:27:43 -08:00
Joyal George K J
23e136562a UI Inconsistency in tooltip fixed by adding the tailwind class for dark theme text color as text-gray-800 2025-11-18 21:44:21 +05:30
David Karlsson
d4bbf9b8e9 llms.txt: add markup for h1
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-13 14:38:01 +01:00
David Karlsson
e17aa3e6a6 llms.txt: only render section links to existing pages
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-13 14:38:01 +01:00
David Karlsson
3a8312bf55 llms.txt: resolve shortcodes in rendered Markdown
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-13 14:38:01 +01:00
David Karlsson
69e7b81888 llms.txt: add page descriptions
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-13 14:38:01 +01:00
David Karlsson
be9c6d7543 llms.txt: reduce whitespaces and remove dud entries
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-13 14:38:01 +01:00
David Karlsson
1f5f50113b site: add state of appdev survey callout to home page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-07 05:12:27 +01:00
Craig Osterhout
54896155f7 scout: fix watch docs (#23506)
<!--Delete sections as needed -->

## Description

Fixes the generated scout watch docs to use examples from the upstream
markdown, instead of the yaml. When previously updated, only the
markdown was updated upstream and not the CLI source which generates the
yaml.

- Added new layout for the scout cli, based on the generic cli layout.
The new layout uses the more extensive markdown examples if present,
otherwise use the examples from the yaml.
- Updated the scout watch topic to use the new layout 

Once fixed upstream, will have a follow up to most likely revert this.



https://deploy-preview-23506--docsdocker.netlify.app/reference/cli/docker/scout/watch/#examples

## Related issues or tickets

Original PR to update the version: #23485. The markdown was updated but
not the yaml.
Upstream fix: https://github.com/docker/scout-cli-plugin/pull/713

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-10-07 08:37:24 -07:00
Craig Osterhout
fdbe2dda62 dhi: add homepage banner (#23451)
<!--Delete sections as needed -->

## Description

Updated old GenAI homepage banner to promote DHI free trial.
https://deploy-preview-23451--docsdocker.netlify.app/

## Related issues or tickets

ENGDOCS-3014
Pending #23420 as this requires the quickstart to have the free trial
flow.

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-30 13:01:23 -07:00
Sarah Sanders
73ba3a54c0 fix: search bar (#23459)
Fix for intermittent bug that happens on the docs site when using the
search bar/search drop-down, reported by Eng
- Fixed disconnected dropdown to keep dropdown attached to search bar
- Added viewport boundary detection for window resizing
- Made search icon clickable (critical for mobile)

Tested on:
- Chrome
- Safari
- Mobile

https://docker.atlassian.net/browse/ENGDOCS-3002
2025-09-26 08:59:56 -04:00
Craig Osterhout
466db49326 update nav dropdown behavior (#23436)
<!--Delete sections as needed -->

## Description

Change how the section drop-down arrows are rendered in the side-nav.

Currently, they generate for any folder, even if it just contains an
index. To not generate the arrow, the index would have to be taken out
of the folder and renamed as the folder.

This change now counts how many children under the index, and only
generates the arrow if it has children (that aren't hidden from the
nav).

For example, see how there is an arrow for the mcp gateway, but it
expands to nothing.
Current: https://docs.docker.com/ai/mcp-gateway/
Updated:
https://deploy-preview-23436--docsdocker.netlify.app/ai/mcp-gateway/

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-22 08:00:15 -07:00
Sarah Sanders
4a666fcc18 fix: rss feed template (#23419)
## Description
- Improvement to RSS feed, add single items for each release item
- This approach requires data .yaml files to keep things clean, Hugo
doesn't output RSS well with just parsing HTML and headings

## Preview
-
https://deploy-preview-23419--docsdocker.netlify.app/desktop/release-notes/index.xml
-
https://deploy-preview-23419--docsdocker.netlify.app/security/security-announcements/

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2999
2025-09-19 10:07:14 -04:00
Usha Mandya
49dc2a288b Update the landing page to include MCP Toolkit banner and card
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2025-09-12 16:51:09 +01:00