181 commits

Author	SHA1	Message	Date
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	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
Rohan Kumar	7efe60a6bc	Stylistic fixes (minor) ... Nothing new, just re-phrasing and capitalization.	2021-02-28 12:52:48 -08:00
Rohan Kumar	fe12f0dc32	Add link to avifenc	2021-02-28 12:40:26 -08:00
Rohan Kumar	13db509ea3	Add idea for website testing: site translation	2021-02-28 12:34:59 -08:00
Rohan Kumar	36a95f894a	Update preferred approach to image processing ... - Include AVIF - Include dark/light variants if applicable	2021-01-28 13:10:40 -08:00
Rohan Kumar	790f7f70ef	Article update: mention brotli ... Brotli support is more prevalent than zstd	2021-01-28 12:20:23 -08:00
Rohan Kumar	2083f1aed5	Article update: include advice on avatar image ... Include info on using an avatar image/profile photo without significantly increasing the footprint of a website, by re-using the favicon image.	2020-12-29 22:34:35 -08:00
Rohan Kumar	8c63605d1a	Add 10 KB Club to web best practices article	2020-12-28 15:33:18 -08:00
Rohan Kumar	8fdee5d244	Include layout in web best practices ... Article update: decribe good layout in the website best practices article.	2020-12-21 16:41:46 -08:00
Rohan Kumar	6331840d95	Fix bad link ... Sourcehut updated its per-object log URLs	2020-12-20 12:57:59 -08:00
rohan kumar	3368f8fea9	Update web best practices article: add testing ... - Add information about testing edge cases - Re-word some long sentences	2020-12-16 18:53:24 -08:00
rohan kumar	bab75dcebc	Clarify HTTP Observatory scores	2020-11-30 12:09:22 -08:00
rohan kumar	4907336d96	Add bit about alt-text, clarify page size	2020-11-30 12:04:21 -08:00
rohan kumar	46512c9046	Update with feedback on page size ... Added the Web Bloat Size Calculator and a snippet on how people on trains experience a connection speed drops. Thanks, u/Snapstromegon from Reddit!	2020-11-27 10:25:03 -08:00
rohan kumar	8e38c66243	Add pngquant to image compression section ... Thanks, arnt and vbernat!	2020-11-25 21:58:37 -08:00
rohan kumar	1ba46835be	Clarification on HTTP/2 ... Thanks, reezer!	2020-11-25 16:36:40 -08:00
rohan kumar	b9207d17ea	Add max line length to web best practices article ... Thanks, u/_listless	2020-11-24 15:32:38 -08:00
rohan kumar	103a860528	Link to article changelog	2020-11-24 14:24:12 -08:00
rohan kumar	d24cdfb423	Link to MDN docs on CSS @media queries	2020-11-24 14:19:20 -08:00
rohan kumar	a1f517c61a	Clarify that branding isn't evil	2020-11-24 10:58:05 -08:00
rohan kumar	2d43a0ddc4	Clarify a snippet on overriding stylesheets ... We shouldn't require users to override stylesheets, but we should expect it.	2020-11-24 10:53:22 -08:00
rohan kumar	8f47970379	More info about fingerprinting via fonts	2020-11-24 04:54:13 -08:00
rohan kumar	f1a56e9ec4	Explain why global stylesheet overrides are bad	2020-11-24 03:50:06 -08:00
rohan kumar	79b91972e7	Add more info on image optimization	2020-11-24 03:18:03 -08:00
rohan kumar	7ec5eab8eb	Clarify the controversial statement on font choice ... The lobste.rs discussion at https://lobste.rs/s/akcw1m/opinionated_list_best_practices_for generated a lot of feedback about fonts, so I thought I'd explain a bit more.	2020-11-24 02:43:59 -08:00
rohan kumar	2cd686a4fb	Add gzip + http2 to website best practices	2020-11-24 02:27:17 -08:00
rohan kumar	6f937ac5a8	Clarify the point of using HTML->md convertors ... Thanks to some IRC users for pointing out how the rationale wasn't very obvious	2020-11-24 01:59:22 -08:00
rohan kumar	e538b0df8e	Fix: s/white-on-black/black-on-white/	2020-11-23 22:56:18 -08:00
rohan kumar	839e6d5737	Update website best practices with color info ... Thanks to a couple IRC users for the feedback.	2020-11-23 19:00:31 -08:00
rohan kumar	dbab08560f	Fix: remove draft post status from gemlog entry	2020-11-23 17:13:48 -08:00
rohan kumar	18ff772d5f	New article: best practices for minimalistic websites	2020-11-23 15:51:57 -08:00