Added alert component, added image description post from fedi

4 files changed, 42 insertions, 1 deletions

diff --git a/content/notebook/fediverse/in-depth-image-descriptions.md b/content/notebook/fediverse/in-depth-image-descriptions.md
new file mode 100644
index 0000000..9fe7e48
--- /dev/null
+++ b/content/notebook/fediverse/in-depth-image-descriptions.md
@@ -0,0 +1,31 @@
+---
+schema_type: DigitalDocument
+title:       Detailed image descriptions aren't always helpful
+date:        2022-05-05
+
+references: 
+  - label: Original Post
+    url:   https://mk.vulpes.one/notes/8zwxp9lywc
+---
+
+::: alert
+I noticed that quite a few people write very extensive image descriptions.
+Mastodon in particular implies that this is the correct way since the character limit for them is [three times as high as the limit for the actual post content](https://github.com/mastodon/mastodon/pull/11819).
+However, there are common situations where these image descriptions are in fact not helpful.
+:::
+
+Imagine you're using an online shop.
+What you'll typically see is a list of products where each list item has a small preview image, a product name and some other metadata.\
+Now imagine that the shop displays a long textual description for each product instead.
+This is what the timeline appears like to screen reader users if long image descriptions are used.
+And unlike people seeing the text, they don't have the luxury of skimming to grasp vital information quickly -- they can only skip the rest of the description at any point, or wait for the screen reader to read all of it.
+
+Detailed descriptions are only helpful when the user has decided the content is interesting to them.
+Currently, most fedi frontends put them in the attachment's `alt` attribute, which is fine if the user is currently viewing a single post instead of the timeline.
+But on the timeline, it's much more important to have quick summaries instead.\
+In terms of the example above, it's the same when viewing a single product vs. the product list.
+You're only interested in the details if a product is interesting to you.
+
+Image description on fedi are a step up from having none at all, but they're still inadequate.
+Ideally, you could provide both a quick summary and an in-depth description, and the UI presents both in a way that's the most helpful.\
+Since this possibility doesn't exist, please consider keeping image descriptions short and putting the long description in the post body.
diff --git a/content/notebook/fediverse/index.md b/content/notebook/fediverse/index.md
new file mode 100644
index 0000000..c628a37
--- /dev/null
+++ b/content/notebook/fediverse/index.md
@@ -0,0 +1,8 @@
+---
+title:                Fediverse
+position:             2
+list_read_indicators: true
+feed:                 true
+---
+
+Longer texts I posted on the fediverse that I wanted to preserve.
diff --git a/content/notebook/scrap/design-test.md b/content/notebook/scrap/design-test.md
index 844bdd1..c7c05ca 100644
--- a/content/notebook/scrap/design-test.md
+++ b/content/notebook/scrap/design-test.md
@@ -1,7 +1,7 @@
 ---
 schema_type: DigitalDocument
 title:       Markdown Test Page
-last_update: 2022-06-16
+last_update: 2021-12-16
 ---
 
 - [Headings](#headings)
diff --git a/content/notebook/scrap/index.md b/content/notebook/scrap/index.md
index 4cc3c2e..26e3298 100644
--- a/content/notebook/scrap/index.md
+++ b/content/notebook/scrap/index.md
@@ -4,3 +4,5 @@ position:             100
 list_read_indicators: true
 feed:                 true
 ---
+
+Test pages and other stuff.