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

224 commits

Author SHA1 Message Date
Rohan Kumar
8cf248d1a4
Web best practices: many minor updates
- Mention Ancienne TLS implementation for vintage computers
- Elaborate on contain-intrinsic-size being safer on long pages, and
  explicitly mention scrollbar-jumping
- Grammar fixes
- Convert a long blurb of hard-to-follow text into bullet points
- Update dated info on this site having no breadcrumbs: it has
  breadcrumbs now. Explain why.
2022-08-17 18:14:52 -07:00
Rohan Kumar
36c9092073
Fix bad links 2022-08-11 21:30:20 -07:00
Rohan Kumar
4f78d1b6ef
Mention real-world benefits of css containment 2022-08-10 17:00:02 -07:00
Rohan Kumar
afd5689d38
Mention FF 104 fixed the focus indicators 2022-08-08 17:30:10 -07:00
Rohan Kumar
ca388d68f5
Add section "against focusable containers"
Explain why making sectioning content focusable ruins tab order.
2022-08-07 17:52:35 -07:00
Rohan Kumar
0f0f7d4724
Add more justifications for advice
- Mention lockdown mode and the Tor Browser disabling 3p fonts
- Mention usvg for simplifying SVGs
- Cite WAI's draft Low Vision Requirements document to justify stance
  against sidebars.
- Trivial rephrasing
- Link to my "two types of privacy" article
- Update references to site colors to reflect changes
- Link to additional reference on buttons versus links.
2022-08-07 17:42:12 -07:00
Rohan Kumar
2ed2bf3c88
More info on optimizing perf for very long pages
Add information about performance of the accessibility tree and how to
offset some difficulties caused by large DOM trees.
2022-08-05 22:41:31 -07:00
Rohan Kumar
c13e0fe690
Minor semantic tweaks
- Add missing p-name microformats to some citations
- Add download link for audio element
2022-08-03 21:33:20 -07:00
Rohan Kumar
c7cf0509a6
Web Best Practices: add lotsa new info
- Add a bunch of new stuff from WAI-Coga's coga-usable doc
- Update outdated CSP example
- Rephrasings
- Elaborate on use of CSS containment
- More on the virtues of URL underlines
- MS Edge does not support AVIF
- More skip-link guidance
- guidance on keeping important content above the fold
- Reference a WebKit bug
2022-08-01 20:57:07 -07:00
Rohan Kumar
ca160f34ca
Various corrections
- update my use of utility clases
- update my use of content-visibility
- rephrase some things
2022-07-21 18:59:14 -07:00
Rohan Kumar
636f80982c
Clarify browser support for visible alt-text 2022-07-21 18:50:05 -07:00
Rohan Kumar
f0a91d2678
a11y: Clarify sarcasm with WAI-Adapt vocabulary 2022-07-11 15:17:12 -07:00
Rohan Kumar
c1854c07ff
Mention Helmholtz–Kohlrausch effect wrt APCA 2022-07-03 22:01:54 -07:00
Rohan Kumar
1a3800ad60
Allow custom article schema.org types 2022-07-01 17:12:22 -07:00
Rohan Kumar
7bd9784653
Microdata: fix relative urls, add a11y metadata
- Add a11y metadata to transcribed images to communicate the presence of
  a transcript
- Fix relative urls in navigation: make them absolute urls, so that the
  parsed navigation elements have the correct destinations.

This also switches image transcripts from a section with a heading to a
div with an ARIA label. That should reduce duplication between the
<summary> content and the heading while still being semantically sound.
2022-06-29 18:05:48 -07:00
Rohan Kumar
8d244920e5
Clarify hyphenation guidelines
Breaking up compound words is safe; otherwise, test pronunciation.
2022-06-27 12:44:14 -07:00
Rohan Kumar
4c7d36e7cf
Use soft hyphens more judiciously
- Recommend others be careful with their use of soft hyphens, and test
  with NVDA. Poorly-placed hyphens can make words sound unclear.
- Dial back my use of soft hyphens to only what's necessary.
2022-06-19 16:23:17 -07:00
Rohan Kumar
fba366ca11
Check and fix broken links 2022-06-17 20:36:35 -07:00
Rohan Kumar
9f3d6b9df3
Re-introduce RSS discoverability alongside Atom
The RSS feeds use escaped HTML instead of XHTML, which improves
compatibility with certain feed readers (e.g. Microsoft Outlook).

Mention that Outlook uses its own weird engine for feed contents in my
web best practices article.
2022-06-17 08:51:53 -07:00
Rohan Kumar
666342d867
mention Brave SpeedReader 2022-06-10 17:25:16 -07:00
Rohan Kumar
3c914b4dd1
Support multiple <dt> that share a <dd>
- Make sure their tap targets do not overlap
- Use a regex to detect them in markup using an "OR" keyword
- Implement them in one article.
2022-06-06 21:42:32 -07:00
Rohan Kumar
f132e194ed
Typo 2022-06-06 16:51:12 -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
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
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
d123bd9a12
New shortcode: "mention-work".
Will be useful when I start posting reply notes.
2022-05-24 17:25:16 -07:00
Rohan Kumar
063ddbb8d9
Elaborate on single-col layout, make evergreen 2022-05-23 17:35:50 -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
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
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
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
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
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
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