1
0
Fork 0
mirror of https://git.sr.ht/~seirdy/seirdy.one synced 2024-11-14 01:32:11 +00:00
Commit graph

332 commits

Author SHA1 Message Date
Rohan Kumar
2f960ca7ec
Better linking, mention DPUB-ARIA, more infscroll
- Annotate links to PDFs and JS-mandatory content
- Add note on dpub-aria to the reading-mode section
- Fix a bad link
2022-04-04 18:11:50 -07:00
Rohan Kumar
8e2e1f9cc5
More information on image transcripts
- Add quote describing how blind readers struggle to find non-semantic context
- Mention that longdesc is deprecated by simple hyperlinks. Describe an alternative.
- Transcripts are necessary for machine translation
- Improve alt-text used alongside an image transcript
2022-04-04 15:46:04 -07:00
Rohan Kumar
f3b2c3ffa6
Rephrasing: better + inclusive use of prepositions
Follow
https://www.gov.uk/government/publications/inclusive-communication/inclusive-language-words-to-use-and-avoid-when-writing-about-disability
to mention disabilities directly with adjectives rather than
prepositions.

Fix my over-use of "with" by using more appropriate prepositions.
2022-04-03 21:10:16 -07:00
Rohan Kumar
73215343ca
Remove obsolete longdesc 2022-04-03 20:53:13 -07:00
Rohan Kumar
b1e7b65e02
Re-organize and clarify some things
- Re-phrase a line referring to a previous section; after some
  re-arrangements, that section is no longer a "previous" section.
- Replace spatial terminology ("bottom") with sequential terminology
  ("end")
- Add note on font enumeration without the Font Access API
- Acknowledge testing in grayscale but emphasize that it isn't enough.
- Move defense of link underlines to just after the section on custom
  colors, since it's more relevant to it.
- Add xkcd image into the page instead of just linking, since the linked
  page content is an image that doesn't include a transcript or
  descriptive alt-text.
- Trivial rephrasings
2022-04-03 19:34:45 -07:00
Rohan Kumar
e5b0963d4f
Typos 2022-04-03 19:18:33 -07:00
Rohan Kumar
05a71fec3d
More accessible article layout
- Make sure that headings don't have the same name as any links, to
  avoid creating links with similar names but different purposes
- Remove useless <aside> elements that wrap landmarks.
- Move TOC down a bit, after the intro.
2022-04-03 16:03:22 -07:00
Rohan Kumar
cef17cef0f
Expand image optimization section
- Elaborate on each image optimization tool
- Mention using GNU Parallel or squoosh.app
- Describe libavif with libaom+butteraugli and the YUV400 color space
- Why you should avoid srcsets based on viewport or display properties
- Fix code snippet for <picture> sample

Threw in some formatting and very minor phrasing fixes.
2022-04-03 13:48:34 -07:00
Rohan Kumar
ec80c3b000
Reflect this site's CSS improvements
See parent commit 60bf9110b9
Link: 60bf9110b9
2022-04-03 23:55:04 -07:00
Rohan Kumar
85523c90e5
Add info to color contrast and img optim
- Elaborate on how contrast needs to be maintained under different
  conditions like different screens, gamma adjustments, and color
  blindnesses
- Add my skepticism about progressive decoding.
2022-04-02 17:46:35 -07:00
Rohan Kumar
1ecf099145
Elaborate on motivation in intro 2022-04-01 18:59:21 -07:00
Rohan Kumar
cd009197a9
Elaborate on speculative preloading with note on analytics 2022-03-31 18:42:50 -07:00
Rohan Kumar
9fbf3f5138
Mention BBR congestion, streamline quotation citations. 2022-03-31 18:42:13 -07:00
Rohan Kumar
6bb659b2cf
Add TCP-aware opim, reorg
Describe round-trip aware optimization

Move some sections around to flow better.
2022-03-31 18:34:53 -07:00
Rohan Kumar
eb8bb710fc
Layout-shift-avoidance, mention zoom and size-adjustment.
- Describe how to calculate intrinsic side to avoid layout-shifts caused
  by CSS Containment
- Mention use of relative font sizes.
- Replace incorrect use of the word "inline" when describing images.
2022-03-31 18:09:40 -07:00
Rohan Kumar
a5b8b5acc9
Introduce css containment for deferring rendering
As alternative to lazy loading.
2022-03-31 17:48:58 -07:00
Rohan Kumar
c21a21ea99
Add acknowledgements, note on justified text
- Say justified alignment is bad
- Add acknowledgements to the further-reading section
- Formatting in intro
2022-03-30 22:12:16 -07:00
Rohan Kumar
4d0851969e
Fix some invalid HTML 2022-03-30 21:02:39 -07:00
Rohan Kumar
5a4510765c
Elaborate on dark themes, cite WAI, cleanup
- Cite WAI more
- Mention merit of dark image variants
- Fix shitty ARIA
- use a <dl> list in one place.
- Describe use of `prefers-contrast: less`
- Narrow screen fixes.
2022-03-30 17:47:13 -07:00
Rohan Kumar
cd622cc85c
Clean up introduction and some phrasing.
- Give the intro a heading
- Make the preface an <aside> with a "doc-preface" DPUB-ARIA role
- Move the TOC before the intro
- Give the TOC a "doc-toc" DPUB-ARIA role
- Provide a TLDR
2022-03-29 19:43:07 -07:00
Rohan Kumar
43a4a6bb1a
Clarify some details about figures, other deets
- Mention that captions can be repositioned relative to figure content
- Edit my captions in light of that fact
- Add unformatted/plain-text agents to "future work"
- Lowercase a heading
2022-03-29 18:29:07 -07:00
Rohan Kumar
689b6bcc3a
New "Beyond alt-text" section, short viewports
Describe how to best include images and figures in a way that flows well
and is accessible to both sighted and non-sighted users.

Describe how sticky elements can be a usability hazard on short
viewports

- Add changefreq
- Clean up structured data for quotations
- Add more sample unorthodox tests

TODO: dark image variant of image in new "Beyond alt-text" section
2022-03-29 18:26:22 -07:00
Rohan Kumar
df8ba551ff
Add TOC, reduce update freq 2022-03-29 18:19:04 -07:00
Rohan Kumar
3a639537b3
Info about csp, halation
- Mention pitfalls of a <meta>-based CSP
- Describe halation a bit more, with an image.
2022-03-28 18:11:55 -07:00
Rohan Kumar
741dc6ed81
Add some info from Fedi and elsewhere
Fediverse users gave good feedback, and I found other info elsewhere.

- Avoid the system-ui font
- Re-clarify article scope (textual websites)
- Mention dynamic content injection
- Describe saving pages offline
- Mention pictures of text versus narrow viewports
- Remove unnecessary info on why i removed margins from figures
- Mention indentation in preformatted code
- Describe appropriate size ranges for inlining images.
- Mention possibility of reporting issues in reading mode section
- Add info on screen readers changing kb nav to "future updates"
- Add info on special keyboard-driven browsers to "future updates"
- Describe best-practices for alt-text, figcaptions, and briefly
  mention transcripts.
- Add a conclusion

Also fix anchors for headings containing HTML entities and some minor
fixes throughout.
2022-03-28 14:56:42 -07:00
Rohan Kumar
cd730698c8
s/most/half/ 2022-03-27 21:04:53 -07:00
Rohan Kumar
312ff228db
Mention and accomodate dyscalculia 2022-03-27 17:32:52 -07:00
Rohan Kumar
d2757f99c5
Details for anti-pagination and Tor a11y
- Pagination hurts searchability
- Tor users can't change media queries, so make the site accessible by
  default.
2022-03-27 17:30:21 -07:00
Rohan Kumar
ccce5c94a9
Inline nav links in print media 2022-03-27 17:24:07 -07:00
Rohan Kumar
6b67668291
Mention inclusive design, tap targets 2022-03-27 17:24:05 -07:00
Rohan Kumar
b0d3189c84
Improve printer-friendliness
Make max line widths only apply to the "screen" media type.
2022-03-27 17:21:13 -07:00
Rohan Kumar
cb0e8a4be9
Mention some suggestions from Fedi
Future updates: add braille displays & clear lang.
Testing: mention zoom levels and caret navigation.
2022-03-27 17:19:13 -07:00
Rohan Kumar
14ec9c4d2c
Update Fairsearch info
Thanks Dmitry!
2022-03-27 13:21:50 -07:00
Rohan Kumar
6048e66d1b
Add info on line length
Introduce a bit more nuance into the WCAG's requirements.
2022-03-27 11:18:25 -07:00
Rohan Kumar
3df423336c
Balance indentation's problems against benefits
Describe how they help users with hand tremors avoid selecting
interactive elements.
2022-03-27 11:16:48 -07:00
Rohan Kumar
07a1b0fb06
Typo 2022-03-27 11:03:10 -07:00
Rohan Kumar
5e93b9d11a
More additions
- Mention calculation of font metrics
- Add related issues to lazy loading
- Justify importance of dark themes
- Trivial formatting tweak in a <pre> block
- Mention OCSP stapling, 0-RTT
- Spelling/grammar help machine translation
- Add more details to "future work" section
- Acknowledge Axess Lab
2022-03-26 16:44:57 -07:00
Rohan Kumar
6a42905002
Typos and fixes
- Hyperlink "h-card" on the Web version of the page
- Forgot to pluralize a word
- s/phrasing/non-phrasing/
2022-03-26 16:39:24 -07:00
Rohan Kumar
ceb19c9308
Re-org web best practices article
- Add a TOC
- Remove the flamebait bulleted list at the top
- Move link underlines section up by one
- Some formatting
2022-03-26 16:35:19 -07:00
Rohan Kumar
422369ea4f
Fix escaped tags in <pre>, remove redundancy 2022-03-26 12:31:51 -07:00
Rohan Kumar
53f4aedf45
info for sec-tests, switch-access, keybot. 2022-03-26 12:31:48 -07:00
Rohan Kumar
391e0b64c5
Move Kozmonavt to "site-finders" category. 2022-03-26 12:31:37 -07:00
Rohan Kumar
a1a33e14ea
Add machine translation notes, proofread 2022-03-25 17:44:10 -07:00
Rohan Kumar
91d2a6567a
Search engines: mention Bloopish might be down 2022-03-21 08:09:34 -07:00
Rohan Kumar
6b402b6ec1
Another typo, formatting 2022-03-20 16:25:46 -07:00
Rohan Kumar
7d3ca83479
Typo 2022-03-20 16:24:14 -07:00
Rohan Kumar
4607ec2d95
Better example of bad custom colors
Add a better screenshot showcasing bad custom colors. Also give it a
figcaption.

The figcaption meant that I had to revise a statement later down when I
said I don't use figcaptions for images.
2022-03-20 16:09:01 -07:00
Rohan Kumar
dd9e791d18
Add You.com under Bing, remove ask.moe
Ask.moe uses Google Custom Search now, so it's not a search engine
anymore; it's a search client.

Lots of people asked about You.com so I put it under Bing.
2022-03-20 11:07:06 -07:00
Rohan Kumar
c6a6e55ede
Add conclusion and criteria for inclusion 2022-03-19 13:42:29 -07:00
Rohan Kumar
013d382f27
Mention "skip links" 2022-03-19 13:40:08 -07:00
Rohan Kumar
458f516655
New engine: Fairsearch 2022-03-19 13:37:11 -07:00
Rohan Kumar
71f1e6fb00
Correction: Bing/Yandex don't need signin either 2022-03-19 12:57:59 -07:00
Rohan Kumar
9f8e41cdb6
Correction: Google submissions don't need sign-in 2022-03-19 11:43:12 -07:00
Rohan Kumar
a027123cd9
Phrasing fix: replace "above" following page reorg
The search tests are no longer "above" the changed sentence so it
shouldn't say "above".
2022-03-17 23:45:53 -07:00
Rohan Kumar
a7e48a35d4
Add Gnomit search engine 2022-03-17 23:43:50 -07:00
Rohan Kumar
1524b40c4a
Mention compatible SVG implementations 2022-03-17 23:37:22 -07:00
Rohan Kumar
fdfd53c3e5
Typo 2022-03-17 23:35:04 -07:00
Rohan Kumar
648771480e
Describe SVG optimization, rephrasings 2022-03-17 23:34:59 -07:00
Rohan Kumar
3bb8f89f74
Phrasing fixes 2022-03-17 23:32:15 -07:00
Rohan Kumar
9098dd5d9a
Describe dark image variants and optimized loading 2022-03-17 23:31:31 -07:00
Rohan Kumar
208b0fe43e
Add info on non-browsers and TLS terminators 2022-03-16 17:09:21 -07:00
Rohan Kumar
cd124986ab
Add recommendations for narrow viewports
These recommendations also included stuff for <figure> elements; in the
spirit of dogfooding, I used some <figure> elements where appropriate
elsewhere in the page.
2022-03-16 17:08:43 -07:00
Rohan Kumar
4d8daf5aa5
Add nonbreaking spaces before version numbers
"WCAG 2.2" shouldn't be broken up; a new line shouldn't start with
"2.2". "WCAG 2.2" should be treated as one word.
2022-03-16 17:00:43 -07:00
Rohan Kumar
66833dc93e
Improve narrow screen compat
- Replace long <code> snippets
- Add some soft hyphens.
- Make one image of text look better on a narrow viewport.
2022-03-16 16:52:03 -07:00
Rohan Kumar
988d278b14
Formatting, info on contrast+halation, Tor notes
- Describe how contrast overkill in dark mode can cause halation
- Add more info on compatibility with the Tor browser
- Mention the rationale for a custom image border color
- More accurately note how in addition to fontconfig mappings, I also
  set my browser preferred font to "sans-serif".
- Clarify that underlines help identify both the beginnings and ends of
  hyperlinks.
- Formatting/phrasing fixes, esp in Gemtext.
2022-03-16 16:49:03 -07:00
Rohan Kumar
5575e2149d
Clarify use of WCAG, update sample CSP 2022-03-16 16:42:31 -07:00
Rohan Kumar
12a6c098f7
Add a11y justifications with citations
Cite the WCAG's supplementary techniques as justification for some
recommendations.
2022-03-16 16:40:04 -07:00
Rohan Kumar
857fc53679
Add info on TLS and a11y
- Recommend reading the WCAG and supplementary information on WCAG
  techniques
- Recommend against broken TLS ciphers.
2022-03-15 17:23:57 -07:00
Rohan Kumar
df51ccc57b
Add Bloopish, kaz.kz, SOLOFIELD. Minor rephrasings 2022-03-15 17:23:28 -07:00
Rohan Kumar
0aefb5d083
Add info on lazy-loading, rephrasings. 2022-03-14 13:50:01 -07:00
Rohan Kumar
f93637455d
More info on biases and structured data
- Expand "rationale" with info on bias
- "rationale" got bigger so I added sub-headings
- Move "rationale" section to the bottom since its increased size pushed
  away the actual engines
2022-03-10 17:11:49 -08:00
Rohan Kumar
ac645a12a7
Add note on engine bias
In response to the flood of traffic I got after DuckDuckGo's
announcement.
2022-03-10 15:29:00 -08:00
Rohan Kumar
3e290a08db
Add GMX and Fireball 2022-03-07 22:44:34 -08:00
Rohan Kumar
86b4012ec0
Mention Brutalist Web Design 2022-03-04 13:55:35 -08:00
Rohan Kumar
760bec2959
Add Toutiao 2022-03-03 19:40:18 -08:00
Rohan Kumar
a6e3ee6e20
New Turkish engine 2022-03-01 20:25:38 -08:00
Rohan Kumar
65c8710b61
RIP Meorca, add info on 3p sources to Brave. 2022-03-01 14:42:59 -08:00
Rohan Kumar
e0a42eeaf2
Add Keybot search engine 2022-03-01 11:48:32 -08:00
Rohan Kumar
028a720186
New engines: semantic scholar, SSEL
Add Semantic Scholar and Secret Search Engine Labs.
2022-03-01 00:35:54 -08:00
Rohan Kumar
e121529f5e
Mention the ask.com network 2022-02-28 13:42:15 -08:00
Rohan Kumar
3c00cfd4e8
Internal: markdown extension for adding link attrs
More concise than using <a> every time i need to add an attr to a link
2022-02-28 13:41:24 -08:00
Rohan Kumar
03e45ae848
Mention visited link color 2022-02-28 02:30:48 -08:00
Rohan Kumar
3cf4bd7191
Elaborate on Mojeek and friendly exclusions. 2022-02-27 15:09:28 -08:00
Rohan Kumar
62b507b738
Remove bad use of <cite> 2022-02-27 11:29:25 -08:00
Rohan Kumar
14f2053fc1
Style: reduce horizontal scroll, element borders
All pages should now look good on screens 230px wide (DPR=1), inc. most
feature-phones running e.g. KaiOS.

Add borders to images so they look distinct from the surrounding page.
2022-02-26 17:18:44 -08:00
Rohan Kumar
4bc0d54ecb
Expand and re-locate "methodology" section 2022-02-26 17:15:14 -08:00
Rohan Kumar
eca3aa9fbb
Sitemap fixes 2022-02-26 01:55:34 -08:00
Rohan Kumar
892c27516a
Link to WCAG 2.2 instead of 2.0 2022-02-26 01:54:26 -08:00
Rohan Kumar
4ca5fed1e9
Better citations 2022-02-26 01:05:44 -08:00
Rohan Kumar
5612220b77
Mention exclusions 2022-02-25 23:43:22 -08:00
Rohan Kumar
d745d65152
New engine: Kagi Search 2022-02-25 20:01:50 -08:00
Rohan Kumar
1201c64d38
Re-vamp "non-generalist search" section.
- Add a couple new engines to non-gen search
- Move search.tl to non-gen search
- Split non-gen search into subsections.
2022-02-25 19:49:11 -08:00
Rohan Kumar
29ae0f3115
Web practices: link underlines are good. 2022-02-24 23:00:49 -08:00
Rohan Kumar
f5101cbc69
Linkify some text for further info
- Add link to tweet stating that Bedrock Edition removed debug symbols
- Add link to sandbox-app-launcher
2022-02-24 21:53:37 -08:00
Rohan Kumar
6e855bb193
Moar linked/structured data
- Add copyrightOwner microdata
- Add person/h-card markup for some more people
2022-02-24 17:55:44 -08:00
Rohan Kumar
97d640a514
First-party link to Black Hat presentation 2022-02-22 22:37:53 -08:00
Rohan Kumar
c203c7f099
Remove avatars from body text
I decided I don't like them
2022-02-22 22:17:13 -08:00
Rohan Kumar
b66a782aa1
Support indieweb avatars 2022-02-22 21:48:10 -08:00
Rohan Kumar
e1484ecb78
Update Neeva info to reflect free tier
Thanks Akumei!
2022-02-22 18:24:36 -08:00
Rohan Kumar
8e16576d2a
Rephrase 2022-02-22 12:54:10 -08:00