180 commits

Author	SHA1	Message	Date
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	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	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	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	a1a33e14ea	Add machine translation notes, proofread	2022-03-25 17:44:10 -07:00
Rohan Kumar	6b402b6ec1	Another typo, formatting	2022-03-20 16:25:46 -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	013d382f27	Mention "skip links"	2022-03-19 13:40:08 -07:00
Rohan Kumar	1524b40c4a	Mention compatible SVG implementations	2022-03-17 23:37:22 -07:00
Rohan Kumar	648771480e	Describe SVG optimization, rephrasings	2022-03-17 23:34:59 -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	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	0aefb5d083	Add info on lazy-loading, rephrasings.	2022-03-14 13:50:01 -07:00
Rohan Kumar	86b4012ec0	Mention Brutalist Web Design	2022-03-04 13:55:35 -08:00
Rohan Kumar	03e45ae848	Mention visited link color	2022-02-28 02:30:48 -08:00
Rohan Kumar	892c27516a	Link to WCAG 2.2 instead of 2.0	2022-02-26 01:54:26 -08:00
Rohan Kumar	29ae0f3115	Web practices: link underlines are good.	2022-02-24 23:00:49 -08:00
Rohan Kumar	c03af0eacc	Use new "indieweb-person" shortcode ... This should reduce a lot of repetition. Supports first/last names, nicknames, generic names that don't conform to first/last norms, and has basic support for affiliated organizations. Also snuck in more info on website colors to the web best practices article, inc. a link to Chris' Wiki.	2022-02-19 12:48:53 -08:00
Rohan Kumar	65ad38d559	Fix broken links/anchors	2022-02-07 21:26:03 -08:00
Rohan Kumar	0d2d25b124	Fix: use HTTPS links where possible	2021-08-16 17:48:36 -07:00
Rohan Kumar	f6413346af	Web best practices: add "security" section ... Add information on restricting site functionality. Add some details on accomodating Tor users.	2021-07-31 17:36:18 -07:00
Rohan Kumar	02dc7822ec	Web best practices: dark themes: Mention OLEDs ... OLED displays use less energy when displaying darker colors.	2021-07-06 09:21:47 -07:00
Rohan Kumar	7ccf84f031	Web best practices: async decode + fingerprinting ... - Mention image async decoding - Describe how width-selector use can enable JS-free viewport fingerprinting	2021-07-02 20:37:24 -07:00
Rohan Kumar	da87f981a2	Web best practices: link to two other places ... Link to the XHTML Club and an article by Bill Dietrich.	2021-06-27 17:37:29 -07:00
Rohan Kumar	aae653056d	Web best practices: link to ECT	2021-06-27 17:02:45 -07:00
Rohan Kumar	5511b354c4	Web best practices: mention Tor users ... Simple sites should work well with the Tor Browser.	2021-06-27 15:26:01 -07:00
Rohan Kumar	8607612e0a	Add recommendations for dark themes	2021-06-13 18:28:15 -07:00
Rohan Kumar	58b64c9a95	Mention ELinks, Netrik ... They're not very actively maintained, but they're still good for testing.	2021-03-15 11:19:50 -07:00
Rohan Kumar	2030e221d7	Add more details about image compression ... - Include a sample command - Describe my approach to deciding on the level of compression/cropping	2021-02-28 13:33:24 -08:00