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