seo: add meta descriptions to docs, tighten blog descriptions

one-kash · one-kash · commit 619a2790b3ae · 2026-07-16T01:20:31.000Z
Add description frontmatter to 24 docs pages that were falling back to
auto-generated, mid-sentence-truncated descriptions. Add link.description to
four generated-index category pages. Trim three over-length blog descriptions
to the ~155-char SERP band, and quote descriptions containing colons or a
'#' so YAML no longer truncates them (this also fixes the challenge post's
description silently cutting off at '#KashCal'). Strengthen two weak titles
(features index, sync index).
diff --git a/blog/2026-06-30-kashcal-challenge.md b/blog/2026-06-30-kashcal-challenge.md
@@ -10,7 +10,7 @@ keywords:
   - google calendar alternative
   - icloud calendar on android
   - caldav calendar app
-description: The free, open-source things KashCal does that most Android calendar apps charge for or skip. Take the KashCal Challenge, tag #KashCal, and dare a friend.
+description: "The free, open-source things KashCal does that most Android calendar apps charge for or skip. Take the KashCal Challenge, tag #KashCal, and dare a friend."
 image: /img/social/home.png
 ---
 
diff --git a/blog/2026-07-05-kashcal-talkback-accessibility.md b/blog/2026-07-05-kashcal-talkback-accessibility.md
@@ -9,7 +9,7 @@ keywords:
   - screen reader calendar android
   - calendar app for blind android
   - colorblind calendar android
-description: "KashCal 2026.07.05 adds full TalkBack support: headings you can jump between, spoken status, and events that say what they are. Cancelled events get crossed off, and you can set the app's language from Android settings."
+description: "KashCal 2026.07.05 adds full TalkBack support: jumpable headings, spoken status, events that say what they are, plus a per-app language setting."
 image: /img/social/home.png
 ---
 
diff --git a/blog/2026-07-13-kashcal-agenda-90-days-timeline-memory.md b/blog/2026-07-13-kashcal-agenda-90-days-timeline-memory.md
@@ -10,7 +10,7 @@ keywords:
   - calendar timeline zoom android
   - agenda month header android
   - android calendar 90 day view
-description: "KashCal 2026.07.13 widens the agenda to 90 days, gives its top bar a scroll-aware month, remembers your timeline zoom across restart, and stops the month view time-traveling to 1969. Here's what changed."
+description: "KashCal 2026.07.13 widens the agenda to 90 days, adds a scroll-aware month header, remembers your timeline zoom across restart, and fixes the month view."
 image: /img/social/home.png
 ---
 
diff --git a/blog/2026-07-15-kashcal-event-tags.md b/blog/2026-07-15-kashcal-event-tags.md
@@ -10,7 +10,7 @@ keywords:
   - calendar event tags android
   - tag events quick add android
   - caldav calendar tags
-description: "KashCal 2026.07.15 adds event tags: colored #chips you set in the form or type into Quick Add, shown across the day, week, and agenda views. Plus fixes for zero-length events, synced emoji, and duration edge cases. Here's what changed."
+description: "KashCal 2026.07.15 adds event tags: colored #chips you set in the form or type into Quick Add, shown across the day, week, and agenda views."
 image: /img/social/home.png
 ---
 
diff --git a/docs/calendar/_category_.json b/docs/calendar/_category_.json
@@ -1 +1 @@
-{ "label": "Calendar & Views", "position": 2, "link": { "type": "generated-index" } }
+{ "label": "Calendar & Views", "position": 2, "link": { "type": "generated-index", "description": "The seven ways KashCal shows your schedule, plus how to navigate and get around fast." } }
diff --git a/docs/calendar/navigation.md b/docs/calendar/navigation.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 2
 title: Navigation & shortcuts
+description: Get around KashCal fast with the navigation drawer, home-screen shortcuts, search, the Today button, and pull-to-sync gestures.
 ---
 
 # Navigation & shortcuts
diff --git a/docs/calendar/views.md b/docs/calendar/views.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 1
 title: Calendar views
+description: "KashCal's seven Android calendar views: month, agenda, day, 3-day, week, full-month, and year, with pinch-to-zoom, drag-to-reschedule, and tag chips."
 ---
 
 # Calendar views
diff --git a/docs/events/_category_.json b/docs/events/_category_.json
@@ -1 +1 @@
-{ "label": "Events", "position": 3, "link": { "type": "generated-index" } }
+{ "label": "Events", "position": 3, "link": { "type": "generated-index", "description": "Create and edit events in KashCal: Quick Add, recurring events, reminders, colors, tags, and attendees." } }
diff --git a/docs/events/colors.md b/docs/events/colors.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 5
 title: Event colors
+description: Give individual events their own color in KashCal, blue for work, green for personal, red for deadlines, so your week reads at a glance.
 ---
 
 import Screenshot from '@site/src/components/Screenshot';
diff --git a/docs/events/event-form.md b/docs/events/event-form.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 2
 title: Creating & editing events
+description: "Set every detail of an event in KashCal on one screen: title, location, time zone, repeat, color, tags, reminders, availability, and attendees."
 ---
 
 import Screenshot from '@site/src/components/Screenshot';
diff --git a/docs/events/quick-add.md b/docs/events/quick-add.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 1
 title: Quick Add (natural language)
+description: "Type an event the way you'd say it, and KashCal's natural-language Quick Add parses the title, date, time, recurrence, location, and #tags."
 ---
 
 import QuickAddDiagram from '@site/src/components/QuickAddDiagram';
diff --git a/docs/events/recurring.md b/docs/events/recurring.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 3
 title: Recurring events
+description: Set repeating events in KashCal, daily, weekly, monthly, or custom patterns, and edit or delete one occurrence, this-and-future, or the whole series.
 ---
 
 # Recurring events
diff --git a/docs/events/reminders.md b/docs/events/reminders.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 4
 title: Reminders
+description: Get a heads-up before an event starts. Add up to five reminders per event in KashCal, with their own timing options for all-day events.
 ---
 
 # Reminders
diff --git a/docs/events/tags.md b/docs/events/tags.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 6
 title: Tags
+description: "Label events with colored tag chips in KashCal, add them in the form or by typing #tag in Quick Add, shown across day, week, and agenda views."
 ---
 
 import Screenshot from '@site/src/components/Screenshot';
diff --git a/docs/features/_category_.json b/docs/features/_category_.json
@@ -1 +1 @@
-{ "label": "More Features", "position": 5, "link": { "type": "generated-index" } }
+{ "label": "More Features", "position": 5, "link": { "type": "generated-index", "description": "Widgets, search, insights, contact birthdays, app lock, backup, languages, and sharing in KashCal." } }
diff --git a/docs/features/app-lock.md b/docs/features/app-lock.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 8
 title: App lock
+description: Keep your calendar for your eyes only. KashCal's app lock hides your events behind your device fingerprint, PIN, or pattern until you unlock.
 ---
 
 # App lock
diff --git a/docs/features/backup-restore.md b/docs/features/backup-restore.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 7
 title: Backup & restore settings
+description: Save your KashCal settings to a JSON file and restore them later, handy for setting up a new phone or keeping a safety net before you experiment.
 ---
 
 # Backup & restore settings
diff --git a/docs/features/birthdays.md b/docs/features/birthdays.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 6
 title: Contact birthdays
+description: Show the birthdays and anniversaries from your contacts right on your KashCal calendar, so you get a nudge before the day and never miss one.
 ---
 
 # Contact birthdays & anniversaries
diff --git a/docs/features/index.md b/docs/features/index.md
@@ -1,7 +1,8 @@
 ---
 sidebar_position: 1
-title: All features
+title: KashCal features
 slug: /features
+description: "Everything KashCal can do: seven calendar views, iCloud and CalDAV sync, Quick Add, reminders, widgets, search, insights, birthdays, and more."
 ---
 
 # All features
diff --git a/docs/features/insights.md b/docs/features/insights.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 5
 title: Insights
+description: See where your week actually went. KashCal Insights breaks down how you spend your time in a few quiet cards, computed entirely on-device.
 ---
 
 import Screenshot from '@site/src/components/Screenshot';
diff --git a/docs/features/languages.md b/docs/features/languages.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 9
 title: Languages
+description: KashCal is translated into 67 languages and follows your device language automatically, or set a specific one for the app from Android settings.
 ---
 
 # Languages
diff --git a/docs/features/search.md b/docs/features/search.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 4
 title: Search
+description: Search across all your events in KashCal in an instant, by title, location, or notes, from the top bar or an app-icon long-press shortcut.
 ---
 
 # Search
diff --git a/docs/features/share-as-card.md b/docs/features/share-as-card.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 10
 title: Share an event as a card
+description: Turn any KashCal event into a good-looking image card with a tap-to-add calendar file attached, so anyone can add it in one tap, no app needed.
 ---
 
 # Share an event as a card
diff --git a/docs/features/widgets.md b/docs/features/widgets.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 3
 title: Home-screen widgets
+description: KashCal's five home-screen widgets keep your day in view, agenda, week, month, and date, each themed to your accent color, no need to open the app.
 ---
 
 import WidgetMock from '@site/src/components/WidgetMock';
diff --git a/docs/getting-started/first-run.md b/docs/getting-started/first-run.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 3
 title: Your first few minutes
+description: KashCal works the moment you open it, no setup or sign-up. Here's how to find your way around and start with a local calendar on your device.
 ---
 
 # Your first few minutes
diff --git a/docs/privacy/_category_.json b/docs/privacy/_category_.json
@@ -1 +1 @@
-{ "label": "Privacy & Security", "position": 6, "link": { "type": "generated-index" } }
+{ "label": "Privacy & Security", "position": 6, "link": { "type": "generated-index", "description": "How KashCal keeps your calendar private: no account, no tracking, and data that stays yours." } }
diff --git a/docs/sync/device-calendars.md b/docs/sync/device-calendars.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 6
 title: Device calendars
+description: Show the Google, Outlook, and work calendars your phone already holds right alongside KashCal's own, so every calendar sits in one place.
 ---
 
 # Device calendars
diff --git a/docs/sync/how-sync-works.md b/docs/sync/how-sync-works.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 2
 title: How sync works
+description: "KashCal is offline-first: everything you do lands instantly on your device and syncs with your CalDAV servers in the background. Here's how."
 ---
 
 # How sync works
diff --git a/docs/sync/ics-subscriptions.md b/docs/sync/ics-subscriptions.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 5
 title: Calendar feeds (ICS subscriptions)
+description: Subscribe to ICS calendar feeds in KashCal, public holidays, team schedules, sports fixtures, and pick how often each one refreshes.
 ---
 
 import Screenshot from '@site/src/components/Screenshot';
diff --git a/docs/sync/import-export.md b/docs/sync/import-export.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 7
 title: Import & export (.ics files)
+description: KashCal reads and writes standard .ics calendar files, so you can move events in or out and keep a portable copy of any calendar.
 ---
 
 # Import & export
diff --git a/docs/sync/index.md b/docs/sync/index.md
@@ -1,7 +1,8 @@
 ---
 sidebar_position: 1
-title: Sync & Accounts overview
+title: Sync & accounts
 slug: /sync
+description: Connect KashCal to the calendar servers you already use. It speaks CalDAV, the open standard behind iCloud, Nextcloud, Fastmail, and most services.
 ---
 
 # Sync & Accounts
diff --git a/docs/sync/supported-servers.md b/docs/sync/supported-servers.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 3
 title: Supported servers
+description: KashCal connects to any CalDAV server, including iCloud, Nextcloud, Fastmail, Radicale, Baikal, SOGo, Zoho, and more, with guides for popular ones.
 ---
 
 # Supported servers

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{ "label": "Calendar & Views", "position": 2, "link": { "type": "generated-index" } }`
	`1`	`+{ "label": "Calendar & Views", "position": 2, "link": { "type": "generated-index", "description": "The seven ways KashCal shows your schedule, plus how to navigate and get around fast." } }`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{ "label": "Events", "position": 3, "link": { "type": "generated-index" } }`
	`1`	`+{ "label": "Events", "position": 3, "link": { "type": "generated-index", "description": "Create and edit events in KashCal: Quick Add, recurring events, reminders, colors, tags, and attendees." } }`