From c21a21ea99778d973f2682e66f1c010a165858a4 Mon Sep 17 00:00:00 2001 From: Rohan Kumar Date: Wed, 30 Mar 2022 22:12:16 -0700 Subject: [PATCH] Add acknowledgements, note on justified text - Say justified alignment is bad - Add acknowledgements to the further-reading section - Formatting in intro --- content/posts/website-best-practices.gmi | 13 ++++++++++++- content/posts/website-best-practices.md | 23 +++++++++++++++++++---- 2 files changed, 31 insertions(+), 5 deletions(-) diff --git a/content/posts/website-best-practices.gmi b/content/posts/website-best-practices.gmi index 103ece2..8040aec 100644 --- a/content/posts/website-best-practices.gmi +++ b/content/posts/website-best-practices.gmi @@ -518,6 +518,8 @@ When setting max line lengths, use a CSS media query to ensure that printed vers } ``` +As words-per-line decrease (by increasing zoom or narrowing the viewport), line lengths grow more varied. Justifying text will cause uncomfortable amounts of whitespace. In fact, "Text is not justified" is explicitly mentioned in Success Criterion 1.4.8. + ## Narrow viewports A single element wider than the viewport will trigger horizontal scrolling for the entire page. This is especially problematic for long pages that already require excessive vertical scrolling. @@ -858,7 +860,9 @@ Moreover, I don't think that the size of a disadvantaged population should alway Before you throw up your hands and decide you can't help everyone, take another skim through this page. Notice how much repetition exists between sections. *Nearly every bullet-point I listed benefits tremendously from plain-old, semantic HTML (POSH)*. If your page is usable with nothing but POSH, you've done half the work already. -## Further reading +## Acknowledgements and further reading + +Initial versions of this page were inspired by existing advocates for web minimalism. Parts of this page can be thought of as an extension to the principles of Brutalist Web Design, which favors "raw content true to its construction": @@ -914,6 +918,13 @@ The WCAG are an excellent starting point for learning about accessibility, but m => https://axesslab.com/articles/ Articles on Axess Lab +I've incorporated much feedback from various places online: + +=> https://pleroma.envs.net/notice/AHqp3TEDFoyz0W4nbc A Fediverse subthread asking people to share ideas +=> https://lobste.rs/s/akcw1m/opinionated_list_best_practices_for An early version of this article posted to Lobsters + +A special thanks goes out to GothAlice for the questions she answered in #webdev on Libera.Chat. + ## Notes ยน Many addons function by injecting content into pages; this significantly weakens many aspects of the browser security model (e.g. site and origin isolation) and should be avoided if at all possible. On sensitive pages with content such as public key fingerprints, I recommend setting a blank "sandbox" directive even if it means breaking these addons. diff --git a/content/posts/website-best-practices.md b/content/posts/website-best-practices.md index 5ef52a4..20f2987 100644 --- a/content/posts/website-best-practices.md +++ b/content/posts/website-best-practices.md @@ -19,7 +19,9 @@ title: An opinionated list of best practices for textual websites _The following applies to minimal websites that focus primarily on text. It does not apply to websites that have a lot of non-textual content. It also does not apply to websites that focus more on generating revenue or pleasing investors than being good websites._ -This is a "living document" that I add to as I receive feedback. See the [changelog](https://git.sr.ht/~seirdy/seirdy.one/log/master/item/content/posts/website-best-practices.md). This is also a somewhat long read; for a summary, just read the introduction and conclusion. +This is a "living document" that I add to as I receive feedback. See the [changelog](https://git.sr.ht/~seirdy/seirdy.one/log/master/item/content/posts/website-best-practices.md). + +If you find the article too long, just read the introduction and conclusion. The table of contents should help you skim. @@ -517,6 +519,8 @@ I opted to wrap all max-width rules in a media query to ensure that they only ge +As words-per-line decrease (by increasing zoom or narrowing the viewport), line lengths grow more varied. Justifying text will cause uncomfortable amounts of whitespace. In fact, Text is not justified is explicitly mentioned in Success Criterion 1.4.8. + Narrow viewports ---------------- @@ -818,8 +822,12 @@ Moreover, I don't think that the size of a disadvantaged population should alway Before you throw up your hands and decide you can't help everyone, take another skim through this page. Notice how much repetition exists between sections. _Nearly every bullet-point I listed benefits tremendously from plain-old, semantic HTML (POSH)_. If your page is usable with nothing but POSH, you've done half the work already. -Further reading ---------------- +
+ +Ack­nowledge­ments and further reading {#further-reading} +---------------------------------------------- + +Initial versions of this page were inspired by existing advocates for web minimalism. Parts of this page can be thought of as an extension to the principles of Brutalist Web Design: @@ -860,6 +868,14 @@ If you've got some time on your hands, I _highly_ recommend reading the [W The WCAG are an excellent starting point for learning about accessibility, but make for a poor stopping point. Much of the content on this page simply isn't covered by the WCAG. One of my favorite resources for learning about what the WCAG _doesn't_ cover is [Axess Lab](https://axesslab.com/articles/). +I've learned about a great number of underrepresented ways to browse from the Fediverse, particularly from [this subthread asking people to share](https://pleroma.envs.net/notice/AHqp3TEDFoyz0W4nbc). Several responses informed updates to this page. + +An early version of this article received useful responses when I [posted it to Lobsters](https://lobste.rs/s/akcw1m/opinionated_list_best_practices_for); I incorporated some feedback shortly afterward. + +A special thanks goes out to GothAlice for the questions she answered in `#webdev` on Libera.Chat. + +
+ [^1]: Many addons function by injecting content into pages; this significantly weakens many aspects of the browser security model (e.g. site and origin isolation) and should be avoided if at all possible. On sensitive pages with content such as public key fingerprints, I recommend setting a blank `sandbox` directive even if it means breaking these addons. @@ -869,4 +885,3 @@ The WCAG are an excellent starting point for learning about accessibility, but m [^4]:

Consider disabling the JIT for your normal browsing too; doing so removes whole classes of vulnera­bilities. In Firefox, navigate to `about:config` and toggle these options:

javascript.options.ion
javascript.options.baselinejit
javascript.options.native_regexp
javascript.options.asmjs
javascript.options.wasm

In Chromium and derivatives, run the browser with `--js-flags='--jitless'`; in the Tor Browser, set the security level to "Safer". -