HTML as a first-class citizen

nationalarchives · Sep 13, 2023 · 566ff39 · 566ff39
1 parent bf2f7c6
commit 566ff39
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 4 deletions.
diff --git a/docs/technology/html.md b/docs/technology/html.md
@@ -1,10 +1,13 @@
 # HTML
 
+1. **Approach**
+    1. HTML-only users MUST be treated as [first-class citizens](https://en.wikipedia.org/wiki/First-class_citizen) ([Service standard - Progressive enhancement](../../ways-of-working/service-standard/#progressive-enhancement))
 1. **Style**
     1. All HTML for National Archive applications MUST adhere to the [HTML5 standard](https://www.w3.org/TR/2011/WD-html5-20110405/)
     1. The `<html>` element SHOULD have a `lang` attribute
     1. The `lang` attribute on the `<html>` element SHOULD be `en-GB`
-    1. The `<title>` element MUST either follow the pattern `[page] - [service] - The National Archives` or `[page] - The National Archives`
+    1. The `lang` attribute on the `<html>` element COULD be `en`
+    1. The `<title>` element SHOULD either follow the pattern `[page] - [service] - The National Archives` or `[page] - The National Archives`
     1. All tags MUST be closed, even where HTML5 might allow them not to be (as is the case for `<li>` and `<p>` tags)
     1. Full attribute syntax MUST be used and all attributes quoted (see the W3C description of [quoted attribute syntax](https://html.spec.whatwg.org/multipage/syntax.html#syntax-attributes))
     1. All tag names and attributes MUST be written in in lower case
@@ -16,7 +19,6 @@
     1. The HTML outline MUST be logical and based on an appropriate, sequentially descending heading structure
     1. In-page navigation MUST be facilitated with "skip to content" and "back to top" links where appropriate
 
-
 ## Images
 
 Acceptable file formats for images are:

diff --git a/docs/ways-of-working/service-standard.md b/docs/ways-of-working/service-standard.md
@@ -8,8 +8,6 @@
 
 ## Progressive enhancement
 
-HTML-only users should be treated as first class citizens.
-
 In acknowledgement of the web's inherent variability this development guide describes an approach based on the principle of progressive enhancement. This approach is in line with Service Manual guidance. In practice this means building the interface of a website or application in layers:
 
 - If the user's browser only supports HTML they get content and the abilities to navigate and interact using forms