Accessibility

How these docs work with a keyboard, screen readers, zoom and high contrast, what still falls short, and how to tell us about a problem.

On this page

We want everyone to be able to use these docs. This page covers docs.trycloudforge.com. It does not cover the CloudForge app itself.

What works

  • You can use every page with a keyboard alone. Press Tab to move, and the focused item is always outlined.
  • The first two stops on every page are Skip to content and Skip to search.
  • Open search with Ctrl+K (⌘+K on a Mac) or /. Move through results with the arrow keys, open one with Enter, close with Esc. Screen readers hear how many results there are.
  • Pages use real headings, lists and tables, and every part of the page is labelled: the site header, the page list, the main content, "On this page" and the footer.
  • Choose System, Light or Dark in the header or footer. System follows your computer's setting.
  • Windows High Contrast and other forced color modes keep links, focus outlines and the current page visible.
  • If your computer is set to reduce motion, the docs turn off smooth scrolling and animation.
  • Text can be zoomed to 200% and the layout reflows to one column on narrow windows without sideways scrolling.
  • Status colors always come with a word, so color is never the only signal.
  • Every page is also available as plain Markdown. Choose View as Markdown under the page title.
  • The docs work without JavaScript. Search then opens a search page with a list of every page.

The standard we aim for

We aim to meet the Web Content Accessibility Guidelines (WCAG) 2.2 at level AA. We test with a keyboard, with browser zoom, in both themes and in forced color mode. The docs have not had an independent accessibility audit yet.

Known gaps

  • The pages have no screenshots of the app yet. When we add them, each will have a text description.
  • The license notices under /notices/ are published exactly as they ship in the app, so they use the notice generator's own plain layout and do not follow your theme.
  • We have not yet tested with every screen reader. If something does not read well, please tell us.

Report a problem

If something on these pages is hard to use, email support@trycloudforge.com with the page address and what happened. Tell us what you use to browse, for example a screen reader or zoom, if you are happy to. We reply by email.

Keyboard shortcuts

Docs keyboard shortcuts
Ctrl + KOpen search
/Open search
?Show this list
[Previous page
]Next page
EscClose search, this list or the menu

Turn these off if they get in the way of speech input or other tools. Ctrl + K always works.