Commit Graph

207 Commits

Author SHA1 Message Date
Stephanie Aurelio e2c65234aa
updates for ui refresh (#19555) 2024-03-04 08:23:51 -08:00
David Karlsson df0455d16f hugo: improve build performance
use cached partials for repeat templates and icons

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-03-04 16:05:28 +01:00
David Karlsson d29dbaf482 style: design updates march 2024
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-03-04 11:58:08 +01:00
David Karlsson 51c1bedfb1 cli: add subcommand links
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-29 16:08:10 +01:00
David Karlsson c04c83ff58 cli: don't render options table if only hidden options
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-29 15:13:29 +01:00
David Karlsson bccab7302a
Merge pull request #19495 from dvdksn/👍💅
site: update thumbnail image
2024-02-28 17:25:07 +01:00
David Karlsson c16a596cf5 site: update thumbnail image
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-28 14:41:09 +01:00
David Karlsson 56679aec98 cli: alternative alias rendering
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-23 15:11:05 +01:00
David Karlsson 36d3f62159 feat: add tooltip partial
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-23 15:03:27 +01:00
David Karlsson adcb1edfa7 chore: style and script refactor
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-23 15:03:27 +01: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
David Karlsson 43e3ccc197 feat: add "introduced" shortcode
The introduced shortcode takes three arguments:

- component id (as defined in site.Params)
- version (should be semver except for engine api)
- link (optional) to e.g. release note

The component and version argument is compared against the min threshold
set in site config.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-20 15:04:55 +01:00
David Karlsson 3703049154
Merge pull request #19344 from dvdksn/improve-landing-page-banner-graphics
site: improve home banner's bg image/color blend
2024-02-15 20:03:32 +01:00
David Karlsson 3d9d8bd59c
Merge pull request #19411 from dvdksn/cli-hoist-stub-content
cli: hoist content in CLI stubs to top
2024-02-15 19:25:59 +01:00
Stephanie Aurelio 00d64404ac
freshness updates (#19404) 2024-02-15 08:35:02 -08:00
David Karlsson 846bf77f93 cli: hoist content in CLI stubs to top
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-15 12:36:56 +01:00
Stephanie Aurelio 75b6fa2dda
Improve access to org onboarding guide (#19354)
* add links to overview pages, fix redirect, update onboarding intro

* highlight enforce sso step

* remove old redirect from metadata
2024-02-13 13:59:48 -08:00
Chaimaa ZEGOUMOU 7e81df10a3 fix: minor UI adjustement for Docker Desktop release notes
- remove extra pipe before Linux installers
- add missing pipe before Mac with intel chip installer
2024-02-08 18:19:43 +01:00
David Karlsson 75dc05388d cli: add links for cli flags
... and remove the column for shorthands.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-08 16:00:01 +01:00
David Karlsson 5e716537cb site: improve home banner's bg image/color blend
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-08 11:00:38 +01:00
David Karlsson ee3c9c6448 site: add lazy loading for images
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-07 17:10:16 +01:00
David Karlsson ca143e00d0
Merge pull request #19304 from dvdksn/self-host-fonts
site: self-host fonts
2024-02-07 10:47:15 +01:00
Stephanie Aurelio d032a17bb5
remove support link (#19297) 2024-02-05 09:38:10 -08:00
David Karlsson 9f856d4c18
Merge pull request #19299 from dvdksn/lighthouse-improvements
site: accessibility improvements
2024-02-05 13:11:53 +01:00
David Karlsson 0f9278b189 site: self-host fonts
Serve web fonts with our own CDN rather than Google's CDN.

This improves the download speed for fonts (dns lookups, reusing tcp
connection with http/2, cache efficiency)

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-04 22:36:05 +01:00
David Karlsson c1cd9f7f84 a11y: add aria label to theme switch button
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-03 17:05:36 +01:00
David Karlsson 14f905327b a11y: remove explicit tabindex on buttons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-03 17:03:48 +01:00
David Karlsson 723006b12b a11y: add link titles in header, footer
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-03 17:03:18 +01:00
David Karlsson 6cd311ad9d a11y: add alt texts to images on home page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-03 16:55:26 +01:00
Stephanie Aurelio 18f1e23c76
Update UI steps to match Admin Console (#19291)
* update ui text references

* update steps for clarity

* update image alignment

* clean up

* remove outdated screenshot
2024-02-02 14:45:57 -08:00
David Karlsson f6191387b6 chore: remove mermaid.js
We're not using mermaid for diagrams anymore so we can prune the
dependency.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-02-01 09:46:24 +01:00
David Karlsson d6627bcbce fix: use flexbox to simplify templates and fix overflow on mobile
The grid col templates weren't working correctly, switched to flexbox to
make it easier to understand and work better on smaller screens.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-28 23:22:17 +01:00
David Karlsson c4f4b43b20 fix: make breadcrumbs fully truncate on mobile
The last element of the breadcrumb (page title) wasn't truncating.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-28 23:20:00 +01:00
David Karlsson 733c95b5a7 fix: don't render menu on home page
The home page context is quite different from regular pages and
sections, so rendering the menu doesn't seem necessary. All the relevant
navigation is available in the main ui.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-28 23:18:33 +01:00
David Karlsson 595dfde3b3 site: redesign landing page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-26 11:20:39 +01:00
David Karlsson aa98f3f975
Merge pull request #19214 from dvdksn/fix-horizontal-overflow
fix horizontal overflow
2024-01-25 21:28:32 +01:00
David Karlsson 393c2027e6 css: improve rendering of breadcrumbs on small screens
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 21:12:59 +01:00
David Karlsson ce9e6317fc css: prevent horizontal overflow on md/sm/xs screens
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 21:12:07 +01:00
David Karlsson e39e1d7864
Merge pull request #19207 from dvdksn/font-display-fallback
font: use font-display:fallback
2024-01-25 17:34:07 +01:00
Allie Sadler f1cdb98a83
ENGDOCS-1931 (#19081)
* ENGDOCS-1931

* format fixes

* PM review

* SME review and update screenshot

* more review edits

* more review edits
2024-01-25 16:11:28 +00:00
David Karlsson 1ed2721b40 font: use font-display:fallback
Provides a more stable experience than `optional`, as it doesn't let the
browser decide whether or not to apply the font.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 14:48:43 +01:00
David Karlsson 047a48d0ab fix: sidebar background in light mode
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 14:22:09 +01:00
David Karlsson 47487acd24 fix: render callout icons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 14:08:48 +01:00
David Karlsson 0ff3eb3aab hugo: migrate font icons to svg
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 12:28:38 +01:00
David Karlsson 558fbdfabc hugo: use inline svgs for sidebar icons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 12:28:38 +01:00
David Karlsson 1f42d72ed3 hugo: support for inline svg icons
This commit adds support for icon optimization using inline svgs,
improving site performance.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 12:28:38 +01:00
David Karlsson b6cb911afc fonts: use font-display:optional insead of swap
Having `font-display: swap` caused FOUT, swapping to `optional` improves
the experience with graceful degradation.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 08:35:41 +01:00
David Karlsson ff459f0dcd css: improve styles to reduce layout shifts
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-25 08:35:33 +01:00
David Karlsson 299ffee524 hugo: improve sidebar rendering and behavior
Removes the alpine.js components for the sidebar, and uses vanilla
eventlisteners instead. Also moved off javascript for handling the
expanse/collapse display, in favor of using css only.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-24 16:34:00 +01:00
David Karlsson 0791ea5e56
Merge pull request #19198 from dvdksn/build-cloud-new-badge
build cloud new badge
2024-01-24 16:29:24 +01:00
David Karlsson 15485594b4 hugo: do not render hidden cli options
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-24 15:51:18 +01:00
David Karlsson 6f2df42f35 hugo: fix vertical alignment for html strings
Strings containing subelements would be misaligned compared to the plain
text. Added centering w/ flexbox just to get it to look right in case
the rendered strings contained html.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-24 15:28:51 +01:00
Allie Sadler dcfe8baa0b
ENGDOCS-1948 (#19121)
* ENGDOCS-1948

* edits

* review edits
2024-01-23 15:53:43 +00:00
David Karlsson e4df074a75 site: dbc landing page banner
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-22 23:49:39 +01:00
David Karlsson ade4ebd4a6
Merge pull request #19045 from dvdksn/cli-canonical-reference-urls
Canonical CLI / moby 25
2024-01-19 16:30:19 +01:00
David Karlsson f0260dbf20 hugo: display command aliases
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-19 16:13:36 +01:00
David Karlsson f2ab28125a
Merge pull request #19127 from dvdksn/site-fixups
site fixups
2024-01-19 15:44:34 +01:00
David Karlsson b1b8263be7 styles: update site logo
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-19 09:59:41 +01:00
Stephanie Aurelio c6eaf89447
add new event to table (#19130) 2024-01-18 11:44:01 -08:00
David Karlsson 16b8554123
Merge pull request #18143 from dvdksn/manuals-overview
ux: manuals landing page
2024-01-18 17:56:22 +01:00
David Karlsson 637a19aa1c site: add manuals landing page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-18 17:52:39 +01:00
David Karlsson 28e564187c site: remove "reading time" indicator
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-15 17:29:17 +01:00
Allie Sadler 418a47c7bc
ENGDOCS-1938-tier2 (#19076) 2024-01-11 08:18:55 +00:00
David Karlsson 04a5ee0915 hugo: use icon utility class for external links
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-08 13:25:03 +01:00
Allie Sadler 9801cb4508
ENGDOCS-1935 (#19040) 2024-01-05 10:17:39 +00:00
Stephanie Aurelio f7e5d35705
Update Image Access Management category descriptions (#19021)
* update category descriptions

* updates for clarity
2024-01-03 11:55:32 -08:00
David Karlsson 834db3da41 css: refactor and improve styles
- Refactoring styles to prevent unwanted specificity issues by using
  tailwind directives
- Improve color consistency for code blocks and other components by
  replacing adhoc hex values with theme colors

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-01-03 14:54:57 +01:00
David Karlsson 6fb66cf034
Merge pull request #18995 from dvdksn/rm-h1-ids
fix: remove heading IDs for h1 elements
2024-01-02 13:44:11 +01:00
David Karlsson 77b0a087c5 fix: remove heading IDs for h1 elements
Closes #18983

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-28 20:55:13 +01:00
David Karlsson c03109f7eb style: gradient header bg
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-28 19:37:28 +01:00
Stephanie Aurelio 482bcb4ec0
Restructure administration docs IA (#18940)
* cli: use the new add-host separator

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

* update organization admin sections

* update company sections and move faqs

* add create company steps and clean up overview

* update faq paths in tiles and add ea banner to admin tab

* fix spaces and update admin console references

* update banner message, clarify content, and streamline onboarding guide

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-19 08:58:20 -08:00
David Karlsson 5167c68f7f
Merge pull request #18610 from dvdksn/hb-ga
hb ga
2023-12-15 21:44:44 +01:00
David Karlsson 444ffdca3a feat: shortcode for linking to section pages
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-14 21:58:02 +01:00
David Karlsson 72725b7708 hugo: handle multiline flag descriptions
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-13 21:14:31 +01:00
David Karlsson f70a077b72 build: add cloud build
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-11 20:34:41 +01:00
David Karlsson c710541f28 a11y: add aria-hidden to external link icons
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-12-11 09:43:11 +01:00
Craig Osterhout b16d30c519
get-started: add landing page w/ walkthroughs (#18808)
* add get-started landing page

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2023-12-04 08:59:34 -08:00
David Karlsson 210ac7bb11 fix: add scroll margin for h1s
h1 elements with IDs need a scroll margin to account for the header and
margin height. These anchors are linked automatically by Algolia.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-23 12:27:31 +01:00
David Karlsson 3ac25b7a2c search: refactor page entries in toc
Wraps the entry title in a span element so that we can have a single
querySelector to get the textContent of the title of a top-level toc
item of a page:

document.querySelector("#sectiontree li:has([aria-current]) :is(a, button) span")

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-22 20:43:36 +01:00
David Karlsson fd264a9df3 search: add docsearch container class and h1 ids
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-22 20:42:52 +01:00
David Karlsson 04e4ef2d78 chore: reinstate scout banner
The survey linked in the previous banner has ended

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-21 17:04:22 +01:00
Craig Osterhout 4924093d89
fix typo (#18729)
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2023-11-20 14:03:00 -08:00
Craig Osterhout 8bb75fa5fa
tier 1 updates for freshness (#18686)
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2023-11-16 07:40:56 -08:00
Stephanie Aurelio b395c3e531
Update and refresh company docs (#18656)
* update company faqs structure diagram and implement support feedback

* update faq and callout

* implement feedback and fix conditional
2023-11-15 13:33:49 -08:00
Allie Sadler d5a60afba1
ENGDOCS-1738b (#18653)
* ENGDOCS-1738b

* fix link
2023-11-13 12:25:48 +00:00
David Karlsson d2dffd4e28
Merge pull request #18649 from dvdksn/heading-ids
feat: improve heading markup and scroll behavior
2023-11-13 07:33:56 +01:00
David Karlsson db85f53af1 feat: improve heading markup and scroll behavior
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-12 20:35:34 +01:00
Craig Osterhout a6c5b99fc0 update homepage banner
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2023-11-10 16:16:14 -08:00
Usha Mandya 7d670672d4 Update the banner title
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2023-11-10 20:46:23 +00:00
Craig Osterhout dea6ac4ea5
update homepage banner (#18636)
* update homepage banner

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2023-11-10 12:26:40 -08:00
David Karlsson a0dca716e9
Revert "search: add a stronger main content identifier" 2023-11-10 15:37:39 +01:00
David Karlsson 3e9563ffc7 search: add breadcrumbs identifier
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-10 14:28:54 +01:00
David Karlsson 72a1be8ec1 search: add a stronger main content identifier
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-10 13:34:25 +01:00
David Karlsson d01789c386 hugo: add support for specifying grid columns
Converts the grid shortcode to use named arguments, and adds support for
a second "cols" argument for specifying grid size (3 by default).

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-09 15:39:51 +01:00
David Karlsson 40546dbbdf ux: add "image" card layout
This change to the cards partial adds support for an alternate layout.

The layout to use is decided based on the input parameter used to
generate the card:

- If an `image` is given, the new "tall image" layout is used
- If an `icon` is given, the default layout is used

Image and icon are mutually exclusive.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-11-09 15:36:57 +01:00
Allie Sadler 0f2fe1de22
ENGDOCS-1771 (#18613)
* ENGDOCS-1771

* fix build

* fix build

* fix build

* fix build

* fix build

* fix build

* fix build

* fix build

* fix build

* fix links

* links

* add cards

* final link fix

* review edits
2023-11-09 09:23:24 +00:00
David Karlsson 9c6f0d5bc0
Merge pull request #18545 from dvdksn/code-blocks-lineno
style: numbered lines for code blocks
2023-10-31 11:45:17 +01:00
Stephanie Aurelio ded98053ee
Update SSO configuration domain steps (#18554)
* remove repeated step and update callout styling

* consistent capitalization
2023-10-30 15:02:25 -07:00
David Karlsson f64276790d feat: numbered lines for code blocks
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2023-10-30 20:48:59 +01:00
Allie Sadler 270c2ef7b6
ENGDOCS-1717 (#18446)
* ENGDOCS-1717

* fix build

* fix build

* fix build

* fix build

* tweak steps

* tweak steps

* review edits

* second review round

* small tweaks

* add known issue

* final edits

* final review

* final review
2023-10-26 16:17:35 +01:00