diff --git a/scribble-lib/scribble/browser-support.md b/scribble-lib/scribble/browser-support.md new file mode 100644 index 0000000000..3dd9a248bc --- /dev/null +++ b/scribble-lib/scribble/browser-support.md @@ -0,0 +1,43 @@ +## Scribble Browser Support Policy + +This document describes the intended browser support range for HTML +manuals generated with `#lang scribble/manual`. + +This policy defines three levels of support: + +- Full support (all features). +- Partial support (documentation features) +- Minimal support (reading documentation text) + +Any feature must work correctly in all browsers with full support. + +Features that are not needed for reading and understanding the +documentation, but that are intended for developers of the +documentation or other specialized audiences, such as links to +implementation, may not work in browsers with only partial support. + +For browsers with minimal support, it will be possible to read the +text of the documentation, but all other features (such as proper +styling or links) may be missing. + +#### Currently supported browsers + +- All "evergreen" browsers current within the past 12 months (this + includes Chrome, Firefox, Safari, Edge, and other regularly-updated + browsers based on similar). "Current" means if that browser was + shipped to users within the past 12 months, it is fully supported. + +- Partial support includes any browser released within the past 5 + years with at least 1% use on https://docs.racket-lang.org. In + practice this is usually the same set as the fully-supported + evergreen browsers; the current usage share should be consulted when + deciding whether a specific older browser still qualifies. + +- Minimal support applies to all widely-distributed browsers that can + reach the documentation. That is, it is important that the text of + the documentation is readable in text-mode browsers such as `lynx` + and `links`, in screen readers, and in other browsers with limited + styling or scripting. (Very old browsers that can no longer establish + a modern TLS connection to the documentation site, such as IE 6, are + out of scope: they cannot load the pages at all.) +