docs: correct and expand interaction detail across user docs

one-kash · one-kash · commit d430f995d3b5 · 2026-07-08T14:40:52.000Z
Verified each change against the app source:

- Fix export: there is no calendar picker; Settings exports the Local calendar to a share sheet (per-event export lives in an event's menu).
- Fix recurring scope labels to the real strings (This event / This and all future / All events); note device events omit All events.
- Fix Force Full Sync location: it lives behind a long-press on the version footer, then a confirm dialog.
- Fix search custom range to the two-tap gesture, and pull-to-refresh gating (needs an account + online).
- Add missing interactions: ICS feed swipe-to-remove/pause/refresh/edit, device-calendar enable switches, month day-panel swipe, drag exclusions, 15-min snap, year strip, +N more badge, reminder custom time + remove, attendee uninvite + Save &amp; notify, More colors + Done, app-lock disable re-auth, account Sync Now/Change Password/Sign Out, widget month nav + add buttons.
diff --git a/docs/calendar/views.md b/docs/calendar/views.md
@@ -12,13 +12,13 @@ navigation drawer.
 
 | View | What it shows |
 |------|---------------|
-| **Month** | A familiar month grid with dots marking days that have events. Tap a day to see its events in a sheet. Swipe left and right to move between months. |
+| **Month** | A familiar month grid with dots marking days that have events. Tap a day to see its events in the panel below, then swipe that panel left or right to step day by day. Swipe the grid itself to move between months. |
 | **Agenda** | A scrolling list of your upcoming events, grouped by date with times. |
 | **Day** | A single day as an hour-by-hour timeline. Overlapping events sit side by side. |
 | **3 Days** | Three days side by side as timelines, a good balance of detail and overview. |
 | **Week** | A full seven-day timeline. The header shows the month and week number. |
 | **Month (Full)** | A month grid where each day grows to show event titles stacked inside the cell, not just dots. |
-| **Year** | All twelve months at a glance. Tap any month to jump straight to it. Swipe to move between years. |
+| **Year** | All twelve months at a glance. Tap any month to jump straight to it, or tap a year in the strip along the top. Swipe to move between years. |
 
 :::tip
 There's also an **Insights** view, reachable from the navigation drawer, that shows
@@ -31,9 +31,10 @@ KashCal is built for touch, so the timeline views (Day, 3 Days, Week) feel good
 under your thumb:
 
 - **Pinch to zoom.** Pinch in or out on the timeline to make the hours shorter or taller.
-- **Drag to reschedule.** Press and hold an event, then drag it to a new time, or sideways to a different day. You'll feel a little buzz when the drag starts.
-- **Tap an empty slot** to start a new event right there.
-- **Swipe left/right** to move to the next or previous day or week.
+- **Drag to reschedule.** Press and hold a timed event, then drag it to a new time, or sideways to a different day. You'll feel a little buzz when the drag starts. (All-day and read-only events, such as those from a holiday feed, can't be dragged.)
+- **Tap an empty slot** to start a new event there, pre-filled to the nearest 15 minutes.
+- **Swipe left/right** to move through time. In Day and 3 Days views a swipe moves one day; in Week view it moves a whole week.
+- **Tap a "+N more" badge** when a day has more events than fit, to see the full list.
 
 In **Month** and **Year** views, swipe left and right to move between months or
 years, and tap a day or month to drill in.
@@ -42,7 +43,7 @@ years, and tap a day or month to drill in.
 
 - **Today.** Tap the Today button to jump back to the current date in any view.
 - **Pick a month.** In Month view, tap the month and year in the header to open a quick month-and-year picker.
-- **Pull to refresh.** Pull down on the calendar to sync with your servers right away.
+- **Pull to refresh.** Once you've connected an account and are online, pull down on the calendar to sync with your servers right away.
 
 ## Landscape and larger screens
 
diff --git a/docs/events/attendees.md b/docs/events/attendees.md
@@ -17,13 +17,17 @@ track of who's coming.
 In the event form, tap **Add attendees**. You can:
 
 - Search your contacts by name (with Contacts permission), or
-- Type an email address directly.
+- Type an email address directly, then tap the **Add "…"** row or press Enter.
 
 KashCal validates email addresses and will prompt you if one looks incomplete:
 
 > Enter a full email address
 
+Each guest appears as a chip; tap the **✕** on a chip to uninvite them.
+
 When you save the event, KashCal sends the invitation through your calendar server.
+Whenever a save will notify guests (a new invitation, a change, or an uninvite), the
+button reads **Save & notify**, so you can see the consequence before you tap.
 
 ## Seeing who's coming
 
diff --git a/docs/events/colors.md b/docs/events/colors.md
@@ -19,8 +19,10 @@ In the event form, tap **Choose Color**. You'll see:
 
 - A **quick palette** of 12 colors covering the main hue families:
   browns, reds, oranges, yellows, greens, teals, blues, purples, pinks, and gray.
-- A **full color browser** with 92 named colors, organized by hue family, when you
-  want something more specific.
+  Tap a swatch to apply it instantly.
+- **More colors** opens a full browser of 92 named colors, organized by hue family,
+  when you want something more specific. Adjust the color wheel there and tap **Done**
+  to confirm.
 
 You can also leave an event on its **calendar default**, so it simply takes the
 color of the calendar it belongs to.
diff --git a/docs/events/recurring.md b/docs/events/recurring.md
@@ -31,9 +31,9 @@ example *"Standup every weekday at 9am"*.
 When you change or delete a repeating event, KashCal asks what you mean. The exact
 wording depends on what you're doing:
 
-- **Editing:** "Just this one", "This and all future", or "All occurrences".
-- **Deleting:** the same scope choices, with "All occurrences" styled as the destructive option.
-- **Dragging to reschedule:** "This event" or "All events".
+- **Editing:** "This event", "This and all future", or "All events".
+- **Deleting:** the same scope choices, with "All events" styled as the destructive option.
+- **Dragging to reschedule:** "This event", "This and all future", or "All events". For events from a device calendar, only "This event" and "This and all future" are offered.
 
 This lets you move *this week's* meeting without disturbing the rest of the
 series, or change the time for *every* future meeting at once.
diff --git a/docs/events/reminders.md b/docs/events/reminders.md
@@ -20,6 +20,9 @@ For **timed events**, the options include:
 - 1 hour, 4 hours before
 - 1 day, 1 week before
 
+Need something in between? Tap a reminder to open a days/hours/minutes picker and set
+any custom lead time. To remove a reminder, tap the **✕** on its row.
+
 For **all-day events**, reminders work a little differently because there's no
 specific start time. Options include:
 
diff --git a/docs/features/app-lock.md b/docs/features/app-lock.md
@@ -28,6 +28,10 @@ Once enabled, KashCal confirms:
 
 > App lock on. KashCal will ask you to authenticate next time you open it.
 
+Turning App lock **off** asks you to authenticate first, so someone holding your
+already-unlocked phone can't quietly disable it. If you cancel that prompt, the lock
+stays on.
+
 ## Good to know
 
 - App lock is a **privacy screen for the app**. It controls who can open KashCal on
diff --git a/docs/features/search.md b/docs/features/search.md
@@ -24,7 +24,7 @@ Narrow results to the time range you care about:
 - **All**: past and future events.
 - **Week**: this week.
 - **Month**: this month.
-- **Custom range**: pick a start date, and an end date for a range (or the same date for a single day).
+- **Custom range**: tap a day, then tap it again for a single day, or tap another day to select the range between them.
 
 This makes it easy to answer questions like "when's my next dentist appointment?" or
 "what did I have on last March?"
diff --git a/docs/features/widgets.md b/docs/features/widgets.md
@@ -17,10 +17,13 @@ home screen, choose **Widgets**, and find KashCal.
 |--------|---------------|
 | **Today's Agenda** | Today's events in a list, with past events dimmed and upcoming ones highlighted. Includes an "add event" button and a friendly empty state when your day is clear. |
 | **Week View** | The next seven days at a glance. |
-| **Month View** | A full month grid with colored dots marking days that have events. |
+| **Month View** | A full month grid with colored dots marking days that have events. Page through months with the ‹ › arrows, tap the title to jump back to the current month, and tap **+** to add an event, all without opening the app. |
 | **Date** | Today's date, styled like an app icon, for a clear at-a-glance day marker. |
 | **Upcoming** | The next ten days of events, skipping empty days so you only see what's actually scheduled. |
 
+Tap any event on a widget to open it in KashCal, and use the **+** button on the
+agenda, month, and upcoming widgets to add one.
+
 ## Keeping widgets current
 
 Widgets refresh when you add, change, or delete events, after a sync, and at the
diff --git a/docs/sync/device-calendars.md b/docs/sync/device-calendars.md
@@ -15,7 +15,10 @@ you bring **Google** and **Outlook** calendars into KashCal.
 1. Open **Settings** → **Device Calendars**.
 2. Toggle it on. KashCal asks for calendar permission:
    > Calendar read permission required. Tap Enable to grant access.
-3. Choose which device calendars to show from the navigation drawer.
+3. Enable the specific calendars you want using the switch on each row. The footer
+   shows how many are enabled.
+4. Once enabled, you can still show or hide those calendars per view from the
+   navigation drawer.
 
 ## Reading vs. editing
 
diff --git a/docs/sync/how-sync-works.md b/docs/sync/how-sync-works.md
@@ -40,7 +40,11 @@ up at the next scheduled sync, or right away when you pull down to refresh.
 
 To save battery and data, KashCal normally fetches only what's **changed** since the
 last sync. Occasionally a server needs a complete refresh, which KashCal handles
-automatically. You can also start one yourself with **Force Full Sync**:
+automatically, so you rarely need to think about it.
+
+If you ever want to force one, long-press the version number at the very bottom of
+Settings to open the debug menu, tap **Force Full Sync**, and confirm. Your local
+changes are preserved:
 
 > This will re-download all calendar data from the server. Local changes will be
 > preserved.
diff --git a/docs/sync/ics-subscriptions.md b/docs/sync/ics-subscriptions.md
@@ -61,8 +61,20 @@ feed might warrant **Daily** or hourly.
 ## Feeds are read-only
 
 Events from a subscription show up alongside your other calendars, but you can't
-edit them in KashCal. They belong to the source feed. To stop following a feed,
-remove the subscription (with an undo option if you change your mind):
+edit them in KashCal. They belong to the source feed.
+
+## Manage or remove a feed
+
+Everything lives on the **Settings** → **Calendar Feeds** list, where each feed is a
+single row:
+
+- **Pause a feed** without deleting it: flip the switch on the row off. Its events
+  stay hidden until you turn it back on, and the row shows **Sync paused**.
+- **Refresh now:** tap the refresh button on the row to pull the latest events
+  straight away, instead of waiting for the next scheduled check.
+- **Edit a feed:** tap the row to change its name, color, or refresh interval.
+- **Remove a feed:** swipe the row left. If you change your mind, tap **Undo** on the
+  confirmation before it disappears:
 
 > Subscription removed
 
diff --git a/docs/sync/import-export.md b/docs/sync/import-export.md
@@ -26,16 +26,21 @@ Common reasons an import won't start:
 - **File not found or cannot be read.**
 - **Invalid calendar file format.**
 
-## Export a calendar to .ics
+## Export to .ics
 
-1. Open **Settings** → **Export**.
-2. Choose the calendar you want to export.
-3. KashCal writes all of its events to an `.ics` file you can save or share.
+To export your whole local calendar:
 
-If a calendar has no events, there's nothing to export:
+1. Open **Settings** and tap **Export Local calendar**.
+2. KashCal writes its events to an `.ics` file and opens the system share sheet, so
+   you can save it or send it anywhere.
+
+If the calendar has no events, there's nothing to export:
 
 > No events to export.
 
+To export a single event instead, open the event and choose **Export as .ics** from
+its menu.
+
 ## Import vs. subscribe
 
 Importing copies events **once** into a calendar you can edit. If you instead want a
diff --git a/docs/sync/providers/caldav.md b/docs/sync/providers/caldav.md
@@ -57,6 +57,14 @@ secure `https://` connection.
 - **Baikal / Radicale**: often self-hosted, so you may need the "Trust insecure connection" option for local or self-signed setups.
 - **Zoho, mailbox.org, Stalwart, SOGo**: enter your normal server address and credentials, and KashCal recognizes these services and adjusts automatically.
 
+## Managing or removing the account
+
+Tap the account in **Settings** → **Accounts** to open its details, where you can:
+
+- **Sync Now** to pull the latest changes immediately.
+- **Change Password** if you rotated your password or app password.
+- **Sign Out** to disconnect the account. KashCal asks you to confirm first.
+
 ## Trouble connecting?
 
 - Confirm the server address is correct and reachable from your phone.
diff --git a/docs/sync/providers/icloud.md b/docs/sync/providers/icloud.md
@@ -46,6 +46,14 @@ That's it. KashCal connects to iCloud automatically. Apple sometimes routes you
 a regional server behind the scenes, and KashCal handles that for you, so you don't
 have to worry about server addresses.
 
+## Managing or removing the account
+
+Tap the account in **Settings** → **Accounts** to open its details, where you can:
+
+- **Sync Now** to pull the latest changes immediately.
+- **Change Password** if you generated a new app-specific password.
+- **Sign Out** to disconnect the account. KashCal asks you to confirm first.
+
 ## Trouble signing in?
 
 - Make sure you're using an **app-specific password**, not your normal password.
