From ad42b30027ec0982b66da518e157a6995c4b309e Mon Sep 17 00:00:00 2001 From: Rohan Kumar Date: Fri, 29 Apr 2022 09:01:40 -0700 Subject: [PATCH] Fix some microdata --- content/posts/website-best-practices.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/posts/website-best-practices.md b/content/posts/website-best-practices.md index 31cde77..927d6e8 100644 --- a/content/posts/website-best-practices.md +++ b/content/posts/website-best-practices.md @@ -599,7 +599,7 @@ Always remember that any color palette you define in your stylesheets is merely Some users' browsers set default page colors that aren't black-on-white. For instance, Linux users who enable GTK style overrides might default to having white text on a dark background. Websites that explicitly set foreground colors but leave the default background color (or vice-versa) end up being difficult to read. The same phenomenon occurs on pages with text foregrounds with image backgrounds. -A second opinion: {{< indieweb-person first-name="Chris" last-name="Siebenmann" url="https://utcc.utoronto.ca/~cks/" itemprop="author" >}} describes this in more detail in {{}}. In short: when setting colors, always set both the foreground and the background color. Don't set just one of the two. +A second opinion: {{< indieweb-person first-name="Chris" last-name="Siebenmann" url="https://utcc.utoronto.ca/~cks/" itemprop="author" >}} describes this in more detail in {{}}. In short: when setting colors, always set both the foreground and the background color. Don't set just one of the two. Chris also describes the importance of visited link colors in [VisitedLinksUsability](https://utcc.utoronto.ca/~cks/space/blog/web/VisitedLinksUsability). @@ -1078,7 +1078,7 @@ Sorry, that was a lot of jargon for a single paragraph. Unfortunately, describin Some reading-mode implemen­tations also support [DPUB-ARIA](https://www.w3.org/TR/dpub-aria-1.1/), but I'd caution against using ARIA when POSH is sufficient: "bad ARIA" can be far more harmful to screen readers than "no ARIA". Only use ARIA to fill in gaps left by POSH. -Again: avoid catering to non-standard implemen­tations' quirks, especially undocumented proprietary ones. Let's not repeat the history of the [browser wars](https://en.wikipedia.org/wiki/Browser_wars). Remember that some implemen­tations have bugs; consider reporting issues when one arises. More information about standard and non-standard behavior of reading modes is in the article {{}} by {{. +Again: avoid catering to non-standard implemen­tations' quirks, especially undocumented proprietary ones. Let's not repeat the history of the [browser wars](https://en.wikipedia.org/wiki/Browser_wars). Remember that some implemen­tations have bugs; consider reporting issues when one arises. More information about standard and non-standard behavior of reading modes is in the article {{}} by {{. Reading modes aren't the only non-browser user agents out there. Plain-text feed readers and link previewers are some other options. I singled out reading modes because of their widespread adoption and value. Decide which other kinds of agents are important to you (if any), and see if they expose a hole in your semantics. @@ -1109,7 +1109,7 @@ For example: machine translation will leave `` and `` blocks as-is. Consider the implications of translating between left-to-right (LTR) and right-to-left (RTL) languages. Do a search through your stylesheets for keywords like "left" and "right" to ensure that styles don't depend too heavily on text direction. Once you've cleared the low-hanging fruit, try translating the page to a language like Arabic. -Websites following this page's layout advice shouldn't need much adjustment. {{ is a comprehensive guide to what can go wrong and how to fix issues. +Websites following this page's layout advice shouldn't need much adjustment. {{ is a comprehensive guide to what can go wrong and how to fix issues. In­accessible default style­sheets {#inaccessible-default-stylesheets} ------------------------------------------ @@ -1441,7 +1441,7 @@ A special thanks goes out to GothAlice for the questions she answered in # [^4]: {{}} by {{ gives a great introduction to how TCP works, if you'd like more details. -[^5]: HPACK and QPACK header compression includes dictionaries containing common header names, and some common header values; HPACK lists them in "Appendix A" of {{}}. If a header name or name-value pair one of these predefined table entries, its effective size can be reduced to a single byte. If a header has a value that isn't covered by the table, consider minifying it by removing unnecessary whitespace. +[^5]: HPACK and QPACK header compression includes dictionaries containing common header names, and some common header values; HPACK lists them in "Appendix A" of {{}}. If a header name or name-value pair one of these predefined table entries, its effective size can be reduced to a single byte. If a header has a value that isn't covered by the table, consider minifying it by removing unnecessary whitespace. Remember that if your golden first kilobyte already lists all essential resources, these could be considered premature optimi­zations. Real bottlenecks lie elsewhere.