From 4e6784b8d57b550ed6d3ad60359b4b1063ef657a Mon Sep 17 00:00:00 2001 From: Kevin Heis Date: Mon, 5 Aug 2024 11:33:34 -0700 Subject: [PATCH 1/2] Update two tables to meet a11y requirements (#51911) --- .../actions/supported-github-runners.md | 72 ++++++------------- 1 file changed, 20 insertions(+), 52 deletions(-) diff --git a/data/reusables/actions/supported-github-runners.md b/data/reusables/actions/supported-github-runners.md index 785dc9861f1a..8981b0a43cc6 100644 --- a/data/reusables/actions/supported-github-runners.md +++ b/data/reusables/actions/supported-github-runners.md @@ -5,12 +5,11 @@ For public repositories, jobs using the workflow labels shown in the table below - - - - - - + + + + + @@ -28,10 +27,7 @@ Linux 14 GB - @@ -47,10 +43,7 @@ Windows 14 GB - @@ -67,10 +60,7 @@ macOS 14 GB - @@ -87,10 +77,7 @@ macOS 14 GB - @@ -107,10 +94,7 @@ macOS 14 GB - @@ -123,12 +107,11 @@ For {% ifversion ghec %}internal and{% endif %} private repositories, jobs using
Virtual MachineProcessor (CPU)Memory (RAM)Storage (SSD)Workflow labelNotesVirtual MachineProcessor (CPU)Memory (RAM)Storage (SSD)Workflow label
-ubuntu-latest, ubuntu-24.04 [Beta], ubuntu-22.04, ubuntu-20.04 - -The ubuntu-latest label currently uses the Ubuntu 22.04 runner image. +ubuntu-latest, ubuntu-24.04 [Beta], ubuntu-22.04, ubuntu-20.04
-windows-latest, windows-2022, windows-2019 - -The windows-latest label currently uses the Windows 2022 runner image. +windows-latest, windows-2022, windows-2019
-macos-12 - -Uses the macOS 12 runner image. +macos-12
-macos-13 - -Uses the macOS 13 runner image. +macos-13
-macos-latest or macos-14 - -The macos-latest label currently uses the macOS 14 runner image. +macos-latest or macos-14
- - - - - - + + + + + @@ -145,10 +128,7 @@ Linux 14 GB - @@ -164,10 +144,7 @@ Windows 14 GB - @@ -184,10 +161,7 @@ macOS 14 GB - @@ -204,10 +178,7 @@ macOS 14 GB - @@ -224,10 +195,7 @@ macOS 14 GB - From e256a9b6731d076f21524ed25baa1087d1646076 Mon Sep 17 00:00:00 2001 From: Kevin Heis Date: Mon, 5 Aug 2024 12:17:06 -0700 Subject: [PATCH 2/2] Create image-density.md (#51903) Co-authored-by: Rachael Sewell --- src/assets/lib/image-density.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 src/assets/lib/image-density.md diff --git a/src/assets/lib/image-density.md b/src/assets/lib/image-density.md new file mode 100644 index 000000000000..9697c5159409 --- /dev/null +++ b/src/assets/lib/image-density.md @@ -0,0 +1,11 @@ +# Image density + +Apple's Retina display technology debuted in 2010. Since then, there's been increasing diversity of pixel densities for images and screenshots. Historically, Docs did not specify or handle pixel densities for images. Depending on screenshotting or output tool, you may end up with a 1x image, 1.5x image, 2x image, or even larger. That means without correction 1x images appear blurry to folks on Retina displays, while for non-Retina displays 1.5x and 2x images appear too large. + +We default to 2x images when rendering images on Docs. This helps get the images to the correct size while also keeping them sharp on high density displays. This change requires us to indicate to the browser what pixel density to use for each image. PPI/DPI metadata settings do not impact browser rendering. + +Most folks are now using Snagit for screenshots. In Snagit, enable the “retina images” setting. This creates images at a 2x size. By creating images at 2x size, this means for folks on high density displays, they see a crisper image. + +We have an exceptions list for images not at 2x. You can verify the size of an image by viewing it in Preview app (or Windows equivalent)... if it appears very large, it's likely a 2x image. If it appears at regular size, even after hitting Command + 0 to reset the scale, then it is likely a 1x image. + +If you need to add a new 1x image, please add it to the exceptions list. If you see an image that appears too small or too large, then we will need to edit the list in that case as well. And in general, please make sure you use Snagit for screenshots using the retina setting enabled.
Virtual MachineProcessor (CPU)Memory (RAM)Storage (SSD)Workflow labelNotesVirtual MachineProcessor (CPU)Memory (RAM)Storage (SSD)Workflow label
-ubuntu-latest, ubuntu-24.04 [Beta], ubuntu-22.04, ubuntu-20.04 - -The ubuntu-latest label currently uses the Ubuntu 22.04 runner image. +ubuntu-latest, ubuntu-24.04 [Beta], ubuntu-22.04, ubuntu-20.04
-windows-latest, windows-2022, windows-2019 - -The windows-latest label currently uses the Windows 2022 runner image. +windows-latest, windows-2022, windows-2019
-macos-12 - -Uses the macOS 12 runner image. +macos-12
-macos-13 - -Uses the macOS 13 runner image. +macos-13
-macos-latest or macos-14 - -The macos-latestlabel currently uses the macOS 14 runner image. +macos-latest or macos-14