1
0
Fork 0
mirror of https://git.sr.ht/~seirdy/seirdy.one synced 2024-11-23 21:02:09 +00:00
Commit graph

614 commits

Author SHA1 Message Date
Rohan Kumar
2e0babc6de
New note: DuckDuckGo and Bing 2022-06-02 20:59:39 -07:00
Rohan Kumar
840bf38de6
Whitespace fixes 2022-06-02 20:01:50 -07:00
Rohan Kumar
74842ce644
New note: JS-enabled engines 2022-06-02 18:32:30 -07:00
Rohan Kumar
f271291f49
Automate reply-context, add more metadata to Atom
- Build reply-context from front-matter
- Add more activitystreams, portblecontacts, ostatus, etc. metadata to
  Atom feed. Inspired by Pleroma's feeds.
2022-06-02 17:36:06 -07:00
Rohan Kumar
71bb714ba2
Amend pale moon note 2022-06-01 17:37:24 -07:00
Rohan Kumar
874414229e
Metadata amendments
- Re-order rel for my homepage's representative h-crad
- Fix the aria-current for the homepage
- Microdata: remove unnecessary "sameAs"
- Reduce "update without adding date updated" timeout to 15min
- Add u-uid and rel=me to my h-card on every page.
2022-06-01 10:04:35 -07:00
Rohan Kumar
7c709cb91e
Fix bad ARIA role 2022-06-01 10:02:13 -07:00
Rohan Kumar
b557bb9474
Fix feed subtitles and descriptions 2022-06-01 09:59:52 -07:00
Rohan Kumar
6f2b2d5fff
New note: Pale Moon 2022-06-01 09:59:40 -07:00
Rohan Kumar
f148720fba
New note: Commodified and commoditized 2022-06-01 00:47:56 -07:00
Rohan Kumar
a46b790a62
Remove microdata from feeds
It's useless and invalid in those contexts, and removing it
significantly trims the file sizes.

Edit a post featuring a microdata code snippet to avoid conflicts.
2022-05-31 20:52:16 -07:00
Rohan Kumar
6a7ac36f11
Add 404 page 2022-05-31 18:07:04 -07:00
Rohan Kumar
1aed7a66d4
Switch to XHTML5 markup
The site now has polygot markup and can handle both XHTML5 and HTML5
parsing rules. My staging site will be XHTML but my main site will be
HTML5, just in case of parse errors.

If other tools (e.g. LightHouse) end up supporting XHTML5, I'll consider
switching the content-type to XHTML.
2022-05-30 17:39:45 -07:00
Rohan Kumar
4201b1ad05
New note: "Things can get better" 2022-05-30 13:24:35 -07:00
Rohan Kumar
232ca4639c
New note: Prologue to the meta post 2022-05-30 12:12:01 -07:00
Rohan Kumar
c82cd646dc
Poggies. 2022-05-29 22:06:03 -07:00
Rohan Kumar
5e732189e0
Typo 2022-05-29 12:02:57 -07:00
Rohan Kumar
7c9013dfec
New note: "On displaying word counts" 2022-05-29 12:02:15 -07:00
Rohan Kumar
12d693690e
New note: soulless pride 2022-05-29 00:10:51 -07:00
Rohan Kumar
1d44bc382d
Marginalia.nu has gone open source 2022-05-28 14:11:51 -07:00
Rohan Kumar
4433603899
New note: site refactor 2022-05-27 17:18:08 -07:00
Rohan Kumar
c84c8d4214
BREAKING: Prettify URLs, add Atom feeds
Adding a bunch of server configs to do the re-directs too.
2022-05-26 18:57:49 -07:00
Rohan Kumar
d6d88f1e92
New note: "New search box" 2022-05-26 17:42:31 -07:00
Rohan Kumar
1e2a243952
New note: signal security 2022-05-26 12:18:45 -07:00
Rohan Kumar
6b8dd5a657
Use <aside> for reply context
Makes it play better with reading modes, etc
2022-05-26 12:17:58 -07:00
Rohan Kumar
10fb1f9e4a
New note: "answer engines" 2022-05-25 19:59:09 -07:00
Rohan Kumar
d123bd9a12
New shortcode: "mention-work".
Will be useful when I start posting reply notes.
2022-05-24 17:25:16 -07:00
Rohan Kumar
5d8fcec511
New note: "dark theme woes" 2022-05-24 16:53:55 -07:00
Rohan Kumar
d409a1ba58
Add "notes"
Short-form posts for microblogging. TODO: implement POSSE.
2022-05-24 16:37:26 -07:00
Rohan Kumar
063ddbb8d9
Elaborate on single-col layout, make evergreen 2022-05-23 17:35:50 -07:00
Rohan Kumar
279d70810e
Support "evergreen" articles
"evergreen" articles don't get outdated and shouldn't be marked with a
published date in previews.
2022-05-23 08:39:24 -07:00
Rohan Kumar
2204ae8861
Microdata improvements
- Semantically link each blog posting to the greater blog
- Fix copyright bullshit
- Make some articles TechArticles
- Remove unnecessary markup
2022-05-20 18:32:21 -07:00
Rohan Kumar
9077660b9f
New section "visible interactive semantics"
Move "in defense of link underlines" to subsection of new "visible
interactive semantics" section. Add info on distinguishing between
buttons and links, and making non-interactive space look visually
distinct from interactive space.
2022-05-19 19:31:24 -07:00
Rohan Kumar
c5eb934555
Clarify horizontal line test, RT-tracking overkill
- round-trip-tracking is overkill for most use-cases
- clarify that horizontal line test is best used for landmarks and for
  multiple different grouping elements, rather than just any grouping
  element.
2022-05-18 18:31:55 -07:00
Rohan Kumar
c124687391
Remove title attributes from <time>
They're not interactive elements and there's no hint that they should be
hovered on. Wrapping them in an <abbr> would just make the markup even
more overcomplicated, so I just dropped the titles.
2022-05-18 17:18:36 -07:00
Rohan Kumar
831c54b4ab
Fix metadata/semantics, clarify alt text length 2022-05-18 11:38:16 -07:00
Rohan Kumar
6d066f8711
Support page-specific open graph images
Allow specifying open graph images for individual pages. Change default
site-wide open graph image alt-text to an empty string since the default
image only has visual value, and is better off hidden from assistive
technologies.

Set an open graph image for two articles.
2022-05-18 09:00:05 -07:00
Rohan Kumar
795e5fc58c
Add footnote about SC 2.4.8, fix gemtext footnotes
Some gemtext footnote refs were missing; some were out of order.
2022-05-17 17:17:20 -07:00
Rohan Kumar
f1867f4255
Add section: "Transfer size and user flows", fixes
- Add new subsection of "optimal loading" that connects WCAG SC 2.4.5
  with payload size.
- Remove/replace some inline formatting.
- Add some in-page-links to definitions and new section
- Replace "click" with "navigate" since not everyone navigates by click.
2022-05-17 08:54:25 -07:00
Rohan Kumar
d543f7a6b2
Limits of translation, hard-wrapped <pre>
Describe current limitations of machine translation for web content, and
encourage authors to hard-wrap <pre> text to limit horizontal scrolling
in widescreen desktop browsers.

Mention KaiOS Readout
2022-05-13 17:23:16 -07:00
Rohan Kumar
e523956ecd
Some additions and fixes
- Benefit of identical source/dom/visual order: layout consistency
- Expand the "horizontal-line test" to be a bit more precise.
- Elaborate on line-length issues in SC 1.4.8
- Add footnote mentioning uBlock Origin's support for blocking large
  media elements
- Update mention of border-colors: I don't set most border colors
  anymore.
- Switch "lighten them up" to "de-saturate them" regarding colors and
  overstimulation.
- Update references to my CSS color palette to reflect changes
- Reduce excessive inline formatting in a blockquote
- Re-phrasings and formatting
2022-05-13 17:14:16 -07:00
Rohan Kumar
e158b93bf2
Update my bios. 2022-05-12 21:08:44 -07:00
Rohan Kumar
a9039e1bde
Adjust image transcript approach
- Use section instead of nested article
- Adjust stylesheets to match above markup changes
- Mention upcoming aria-details
2022-05-12 17:33:12 -07:00
Rohan Kumar
b5bf54ff45
Fix missing itemprop 2022-05-11 23:40:24 -07:00
Rohan Kumar
a96b77793b
More CSS containment, adopt shortcodes
- Adopt more shortcodes in older posts.
- Contain figures, excluding images. Slightly decreases paint times.
- Fix spacing issues for nested articles.
- Always enable vertical scrollbar, since pretty much all pages are
  taller than the viewport. Eliminates a layout shift.
- Moar microdata
- Set fixed updated dates for some posts so they don't get new
  date-updated values until I actually change the content significantly
2022-05-11 23:32:35 -07:00
Rohan Kumar
8f4e1b7468
Disable resume post-meta, only use .gmi changelog
- Only show changelogs for gemtext since they only include changes to
  content rather than semantics
- Disable useless post meta on resume.
2022-05-11 21:29:47 -07:00
Rohan Kumar
fb84eb5d12
Minor microdata/whitespace fixes 2022-05-10 16:05:22 -07:00
Rohan Kumar
71dc86faf9
Fix non-interactive space section & impl
Improve non-interactive space on the homepage and use a better
screenshot to illustrate the concept.
2022-05-09 17:51:44 -07:00
Rohan Kumar
4f177f5536
Use less harsh colors in a screenshot
Make the dark link underlines screenshot less prone to overstimulation
2022-05-09 08:25:13 -07:00
Rohan Kumar
7bd796a44c
Floating block examples, Tkhtml, semantics, other
- Change a quote of a code snippet to a code snippet with a citation
- Mention tkhtml
- Mention pandoc and printfriendly as exmples of moving figure elements
  like floating blocks.
- Make TPGi a publisher, not an author.
- Use brackets to clarify a reference in a quotation.
- Add personal example of why it's important to test both low- and
  high-end displays.
2022-05-08 21:08:08 -07:00
Rohan Kumar
88ca957941
add info on watches/translation/indentation/other
- Mention device-adjust
- translation tools don't always understand nested translate directives
- another pitfall of over-reliance on indentation: nested indented
  elements are ambiguous
- Fix some typos
- Update outdatead references to my site's CSS that I've since changed.
2022-05-07 22:17:27 -07:00
Rohan Kumar
3cd44b2ce5
Typos, grammar, descriptive names, etc. 2022-05-06 22:15:29 -07:00
Rohan Kumar
f5f0785e65
Microdata: add itemid attributes 2022-05-06 10:33:42 -07:00
Rohan Kumar
6ebbd739fd
Fix image structured data 2022-05-06 10:30:11 -07:00
Rohan Kumar
ee498b9745
Fix broken link 2022-05-05 20:39:23 -07:00
Rohan Kumar
89b0e01e66
Fix microdata nesting
Make sure separate elements are part of each other so only a single
element is at the top level.
2022-05-05 19:57:27 -07:00
Rohan Kumar
bf07611639
Update guidance on tap target and non-interactive size 2022-05-05 15:31:30 -07:00
Rohan Kumar
d97481f381
Homepage refactor
- Make webring links touch-friendly and accessible by using spaced-out
  details elements.
- Make details elements touch-friendly by indicating interactive region
  area and making summary padded.
- Sort featured posts by featured order.
- Ensure that at least one non-interactive tappable region exists on the
  screen at all times, 48x48 px.
2022-05-04 22:22:38 -07:00
Rohan Kumar
aee6d9410c
Drop a featured article
Compensates for the text added to the homepage in the parent commit.
2022-05-03 22:01:18 -07:00
Rohan Kumar
781f910f99
POSH: replace some divs with <section>s, add <p>
- Put webmention list items in <p>
- make doc-endnotes a section again
- make doc-preface a section with a heading apart from the TOC.
2022-05-03 21:30:20 -07:00
Rohan Kumar
1863c65dce
Trivial rephrase, keeps a figure from overflowing 2022-05-03 17:09:21 -07:00
Rohan Kumar
992ba534af
restricted enhancement, rename article, narrow vp
- Define term "restricted enhancement"
- Rename article (shorter title)
- Better support for narrow viewports
2022-05-02 21:13:50 -07:00
Rohan Kumar
adcccad94e
Website tests: add test exclusions 2022-05-02 17:09:46 -07:00
Rohan Kumar
1502d59e59
Add automated testing tools, better link names
Split "testing" section up into two subsections, with one subsection for
automated testing tools.

Split "The Tor Browser" section into two subsections.

Make link names more descriptive.
2022-05-02 15:42:44 -07:00
Rohan Kumar
321f851431
Remove responsive navbar
It's mobile-friendly as-is. I made sure that tap-targets were even
bigger and more spaced-apart, just to be safe.

Hide unnecessary nav-links in print mode.
2022-05-01 17:04:20 -07:00
Rohan Kumar
cc59c9abf0
More about APCA, RCWN, allow-same-origin, typos 2022-04-29 17:37:24 -07:00
Rohan Kumar
ad42b30027
Fix some microdata 2022-04-29 09:01:40 -07:00
Rohan Kumar
cb2337fb0f
Typo 2022-04-29 08:57:06 -07:00
Rohan Kumar
543bbbc502
Fix some url redirects 2022-04-29 08:54:36 -07:00
Rohan Kumar
b22ec089f8
Rephrase, mention problems with role=text. 2022-04-28 17:43:46 -07:00
Rohan Kumar
fb6e91c820
Reduce accidental skips, add transcript, microdata
When a figure is in the middle of a section, mobile screen reader users
might not switch away from heading-based navigation. Instead, they might
just jump to the next heading.

Re-organize the page to put some skippable content closer to the end of
sections, and add a section describing the need for this.

Also add a transcript to the screenshot of BMFW, and adopt the new
quotecaption shortcode, and fix some structured data by using some
shortcodes properly.
2022-04-27 17:53:50 -07:00
Rohan Kumar
371253c2dc
Improve code blocks
- Support defining text in a codeblock that can be translated
- Shrink some blocks to prevent page breaks on print
2022-04-27 08:53:39 -07:00
Rohan Kumar
048a8147cc
Fix broken link 2022-04-27 08:45:47 -07:00
Rohan Kumar
f964152072
Add SerenityOS screenshot
obv gotta show off that awesome retro desktop
2022-04-26 22:39:12 -07:00
Rohan Kumar
f8cc34f37b
Phrasing 2022-04-26 17:22:18 -07:00
Rohan Kumar
447b8463bb
Elaborate on HPACK/QPACK, simplify code snippet 2022-04-26 17:16:29 -07:00
Rohan Kumar
4f846cea91
Homepage: be concise 2022-04-26 17:09:28 -07:00
Rohan Kumar
16b30d474c
Typo 2022-04-26 09:21:11 -07:00
Rohan Kumar
4ed64cf96e
off-by-one error 2022-04-26 09:20:31 -07:00
Rohan Kumar
75e3e019c7
More on color overrides, some hyphens. 2022-04-25 22:12:53 -07:00
Rohan Kumar
5afbe2b108
Trivial typo 2022-04-25 20:04:07 -07:00
Rohan Kumar
3db1d6ca1b
Mention FoUC + WFoD, and more on ATs
- Mention the browser-AT relation.
- Mention symbol names versus appearance.
- Also throw in a doc-tip
2022-04-25 17:40:16 -07:00
Rohan Kumar
a5245b26fa
Remove broken link 2022-04-25 17:35:46 -07:00
Rohan Kumar
99963aebf1
A11y: fix urls with the same name 2022-04-25 17:33:57 -07:00
Rohan Kumar
b12bdb543f
Remove unused class 2022-04-25 17:29:57 -07:00
Rohan Kumar
eb8ca07b9f
Goldmark 1.4.12, switch to good unminified output
- Goldmark 1.4.12 switches footnotes from a <section> to a <div>; update
  regexes and stylesheet to account for this.
- Goldmark 1.4.12 allows multiple footnotes with the same reference; use
  that.
- Clean up templates for unminified output. Also delete an unused class.
- Switch to unminified output by default.
2022-04-25 08:49:13 -07:00
Rohan Kumar
4e65794972
Remove repetitive link. 2022-04-24 22:03:51 -07:00
Rohan Kumar
76bc44b9a2
Shorter alt-text, unique link names. 2022-04-24 21:53:19 -07:00
Rohan Kumar
715fb820ec
Rephrasings to make descriptions less spatial 2022-04-24 16:53:46 -07:00
Rohan Kumar
86def57b1b
Fix some dated info
Some changes on my site weren't reflected in the article content.
2022-04-23 20:20:17 -07:00
Rohan Kumar
a84a6d8520
Add indetdex engines 2022-04-23 20:13:22 -07:00
Rohan Kumar
8ddc2ec879
Make transcript the description of the image. 2022-04-22 11:48:22 -07:00
Rohan Kumar
d3806e630c
Shorten some unnecessarily verbose alt-text
The same necessary information is conveyed, but now it's shorter. Also
removed some extra redundant information.
2022-04-22 08:49:27 -07:00
Rohan Kumar
0dc6ee1258
New "contrast is complex" sub-section
Elaborate on how hues with good perceptual contrast can be
over-stimulating, so we should try to make them "washed-out" when
possible.
2022-04-21 23:01:35 -07:00
Rohan Kumar
c939afbc0a
Elaborate on focus indicators + fix anchors 2022-04-21 21:40:40 -07:00
Rohan Kumar
120232a403
Re-do my approach to image transcripts.
Way better now. Also introduce a way to emphasize some keywords in code
blocks without going full syntax-highlighting.
2022-04-20 17:55:13 -07:00
Rohan Kumar
50c3ec981c
Improve + talk about image transcripts some more 2022-04-20 17:36:02 -07:00
Rohan Kumar
8d1fa33d0c
Add more info on Windows High Contrast mode 2022-04-19 20:19:58 -07:00
Rohan Kumar
49c14a8b2a
Re-order some resume bits 2022-04-19 20:15:55 -07:00
Rohan Kumar
432fa923af
Update my bios
Just realized my site makes me look like a massive techbro. Ugh. Added
some info about my other interests, esp. a11y and inclusive design.
2022-04-19 20:11:56 -07:00
Rohan Kumar
8e8512290b
Fix invalid HTML 2022-04-19 20:07:30 -07:00
Rohan Kumar
52a7b8a737
Fix overflow 2022-04-19 18:17:21 -07:00
Rohan Kumar
01e52bad16
Split up figcaption partial, add some fignos
- give code blocks their own figure numbers/names/ID
- Split figcaption into quotecaption and codecaption
- create codefigure partial to reduce markup for SoftwareSourceCode
  figures
2022-04-19 18:06:57 -07:00
Rohan Kumar
84cde2e97f
Internal: create + use figure shortcodes + hooks
Create a for <figcaption> and a render hook for code snippets inside
figures, replacing some ugly and complex inline HTML in my markdown
sources.

The only visible change is slightly worse HTML alignment and programming
language indicators (with microdata).

This removed the need to use one of the regex replacements in the
processed_content.html shortcode, and increased the minimum required
Hugo version to 0.93.
2022-04-18 21:15:29 -07:00
Rohan Kumar
e59f3b6e15
Expand "Accessible skimming" section
I've learned a lot about landmarks recently.
2022-04-18 21:20:50 -07:00
Rohan Kumar
78d9ddb749
Mention screen reader verbosity and noise 2022-04-18 21:06:21 -07:00
Rohan Kumar
8d34425e45
Markdown style, put some figcaptions in paragraphs
Figcaptions for code snippets should be in their own paragraphs, since
they're a bit more descriptive.
2022-04-18 08:57:33 -07:00
Rohan Kumar
92f1d70128
Fix TOC aria labels, avoid bad spatial word choice 2022-04-18 01:29:05 -07:00
Rohan Kumar
9d34f82f5d
Limit homepage posts to featured posts 2022-04-18 00:31:19 -07:00
Rohan Kumar
e4b5d59520
Reference other article, phrasing, fix double id 2022-04-18 00:09:09 -07:00
Rohan Kumar
8bc7176e6d
Fix broken anchor link 2022-04-17 13:07:20 -07:00
Rohan Kumar
ca3e997c61
Remove redundant link and trailing whitespace. 2022-04-17 13:03:39 -07:00
Rohan Kumar
c2e146e7bc
More narrow screen optim for old browsers
Some old browser engines don't fully support hyphenation, so they need
some extra help. Now, the entire site should fit in a 150 CSS-pixel wide
viewport.

Clean up some link text too so the text alone is more useful.
2022-04-15 21:06:28 -07:00
Rohan Kumar
3632ab0bc1
Cleanup: remove redundant link, word break
Some browsers don't break words with hyphens.
2022-04-14 22:51:21 -07:00
Rohan Kumar
107643dfb5
Add missing screenshot of focus indicators 2022-04-14 22:51:05 -07:00
Rohan Kumar
7726d8341e
Even more narrow optim
Should now work on a viewport of 150px
2022-04-14 22:15:36 -07:00
Rohan Kumar
401837952f
Make all pages look good in 150px viewports
All pages except bookmarks can now fit on your smartwatch without any
adjustments, so we can disable the auto-zoom-out-to-match-mobile
wizardry that watch browsers do (comparable to the
zoom-out-to-match-desktop stuff that early mobile browsers did).

Yay.
2022-04-13 18:43:12 -07:00
Rohan Kumar
98979f33de
Mention smartwatches with web browsers
Support extremely narrow viewports. Add some hyphens accordingly.
2022-04-13 18:42:52 -07:00
Rohan Kumar
5d8a86f27f
Fix whitespace again 2022-04-13 18:25:59 -07:00
Rohan Kumar
2bfc97df9a
Add section on inaccessible browser stylesheets 2022-04-13 18:15:42 -07:00
Rohan Kumar
e3cf310fb9
Meorca is back 2022-04-11 16:47:11 -07:00
Rohan Kumar
c9d3f0c178
Link Speed Index docs, spelling 2022-04-11 16:46:09 -07:00
Rohan Kumar
37860608d0
More on dark stylesheets
- More on the APCA being premature
- Notes on WebKit's shitty default dark colors needing to be overridden
2022-04-11 16:12:57 -07:00
Rohan Kumar
3200333424
Shorter alts, formatting, redundant links, cleanup
- Shrink some excessive alt text
- Remove some redundant links
- Screenreaders that split elements up aren't just on touchscreens
- Mention ChromeVox in list of screen readers
- Move TOC higher in page
- Spelling
- Drop more unused classes
2022-04-09 08:59:12 -07:00
Rohan Kumar
41b66d8ceb
Put TOC heading inside the TOC <nav>
Putting the heading in the navigation element makes the structure more
logical and matches the behavior of most other websites.

Move it before the introduction in my web best practices post.
2022-04-09 08:51:10 -07:00
Rohan Kumar
072ab1dfff
Add + comply with notes on screen reader support
- Replace hashes in code snippets with variables for screen-readability
- Use hyphens where valid instead of combined words for screen reader
  pronunciation
- Typo
- Add WIP section on screen reader support tips not already covered.
2022-04-10 17:24:59 -07:00
Rohan Kumar
e63e856c9a
Typo, mention problematic Immersive Reader css 2022-04-09 12:22:51 -07:00
Rohan Kumar
dc8a635cf9
Fix hole in privacy policy
I hope nobody noticed
2022-04-08 21:03:02 -07:00
Rohan Kumar
a3b8eb87b7
Add image of hidden search matches, wrapping fixes
- Add ugly screenshot of reddit redesign
- Fix wrapping on narrow viewports
2022-04-08 21:01:08 -07:00
Rohan Kumar
91eef19a8e
Add "in-page search" sec, other additions
- New section on in-page search
- Mention most alt search indexes don't support JS
- Background images bad
- More sample tests: word processors that support HTML
2022-04-08 17:18:45 -07:00
Rohan Kumar
9ba563d868
Rephrasings, inc. more clear link names
Minor rephrasings of some stuff, partially to improve link names (a11y)
2022-04-07 15:42:09 -07:00
Rohan Kumar
069dca0a06
New subsection on cache, semantic code snippets
Add "Don't count on the cache" under the "Optimal loading" section.

Some semantics for code snippets, including switching some from <code>
to <samp>.
2022-04-06 23:42:10 -07:00
Rohan Kumar
89f04e2f31
Fix structured data 2022-04-06 23:14:13 -07:00
Rohan Kumar
fb3312eaed
Update bloopish URL 2022-04-06 22:02:24 -07:00
Rohan Kumar
c0d511b7c9
Mark up and widen code snippets 2022-04-06 19:02:17 -07:00
Rohan Kumar
aab9356cf2
New section on spacing, other additions
- Mention checking privacy policies for 3p content
- Elaborate on more mainstream examples of color overrides
- Link to CSS WG docs instead of MDN for prefers-contrast since they're
  more detailed.
- Specify that I'm just removing margins in <figure> elements for
  quotations.
2022-04-06 17:49:19 -07:00
Rohan Kumar
ba637cf1db
Add obligatory privacy policy
TLDR: I don't collect anything except for default access logs purged
every other day
2022-04-04 19:20:14 -07:00
Rohan Kumar
27ccfaca7b
Add info on non-breaing spaces. 2022-04-04 19:17:52 -07:00
Rohan Kumar
48a18e22c5
Improve narrow-screen and mobile compat
Add soft hyphens to search engines and homepage.

But search engine list items in paragraphs to use the user-agent's
preferred paragraph spacing.
2022-04-04 19:12:46 -07:00
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