docs(compare): address comparison content and SEO audit

Author: antonreshetov

docs/website/.vitepress/config.mts

@@ -68,13 +68,50 @@ export default defineConfig({
     ['meta', { name: 'google-site-verification', content: gsv }],
   ],
 
-  transformHead({ pageData, title, description }) {
-    return buildSeoHead({
+  transformPageData(pageData) {
+    const pageTitle = pageData.title || siteTitle
+    const titleTemplate = pageData.titleTemplate ?? siteTitle
+    const socialTitle = titleTemplate === false || pageTitle === titleTemplate
+      ? pageTitle
+      : `${pageTitle} | ${titleTemplate === true ? siteTitle : titleTemplate}`
+    const head = buildSeoHead({
       relativePath: pageData.relativePath,
-      pageTitle: title,
-      pageDescription: description,
+      pageTitle: socialTitle,
+      pageDescription: pageData.description || description,
       isNotFound: pageData.isNotFound,
     })
+
+    if (pageData.relativePath.startsWith('compare/') && !pageData.isNotFound) {
+      const breadcrumbs = [
+        { name: 'Home', item: `${siteUrl}/` },
+        { name: 'Compare', item: `${siteUrl}/compare/` },
+      ]
+
+      if (pageData.relativePath !== 'compare/index.md') {
+        breadcrumbs.push({
+          name: pageData.title,
+          item: resolvePageUrl(pageData.relativePath),
+        })
+      }
+
+      head.push(['script', { type: 'application/ld+json' }, JSON.stringify({
+        '@context': 'https://schema.org',
+        '@type': 'BreadcrumbList',
+        'itemListElement': breadcrumbs.map((breadcrumb, index) => ({
+          '@type': 'ListItem',
+          'position': index + 1,
+          ...breadcrumb,
+        })),
+      })])
+    }
+
+    // Page head is included in both rendered HTML and client-side navigation.
+    pageData.frontmatter.head = [...(pageData.frontmatter.head || []), ...head]
+  },
+
+  transformHead({ pageData }) {
+    if (pageData.isNotFound)
+      return [['meta', { name: 'robots', content: 'noindex, nofollow' }]]
   },
 
   themeConfig: {

docs/website/compare/apple-reminders.md

@@ -1,14 +1,19 @@
 ---
 title: massCode vs Apple Reminders
-description: "An honest comparison between massCode tasks and Apple Reminders. Cross-platform open-source developer workspace vs free Apple-built-in task manager with iCloud sync."
+titleTemplate: false
+description: "Compare massCode tasks with Apple Reminders: Markdown notes, desktop platforms, iCloud web access, recurring tasks, alerts, and shared lists."
 ---
 
+[Home](/) / [Compare](/compare/) / massCode vs Apple Reminders
+
 # massCode vs Apple Reminders
 
 [Apple Reminders](https://www.apple.com/ios/reminders/) ships free with every Mac, iPhone, iPad, Apple Watch, and Vision Pro. It is the default task manager for most Apple users. massCode is a free, open-source, cross-platform developer workspace where [tasks are notes](/documentation/notes/tasks) — plain Markdown files in a vault on your own disk.
 
 If you are entirely on Apple devices and want a zero-friction default task app, Reminders is the more natural fit. If you work across operating systems, or you want tasks to live as markdown next to your snippets and notes, massCode is the more natural fit.
 
+[Try massCode](/download/) with one engineering note that needs a status and due date.
+
 ## At a glance
 
 | | massCode | Apple Reminders |
@@ -18,7 +23,7 @@ If you are entirely on Apple devices and want a zero-friction default task app,
 | Data location | Local Markdown Vault on your disk | Local on each device, synced via iCloud |
 | Sync | iCloud, Dropbox, Google Drive, Syncthing, Git — your choice | iCloud only |
 | Native platforms | macOS, Windows, Linux | macOS, iPadOS, iOS, watchOS, visionOS |
-| Web access | No web app | View-only web access at [icloud.com/reminders](https://www.icloud.com/reminders) |
+| Web access | No web app | Create, complete, and delete reminders at [icloud.com/reminders](https://www.icloud.com/reminders) |
 | Windows / Linux native app | Yes | No |
 | Task model | Notes with `status`, `priority`, and `due` properties | Reminders with subtasks, sections, tags, smart lists |
 | Statuses | Todo, In Progress, Done, Blocked | Open / completed |
@@ -31,7 +36,7 @@ If you are entirely on Apple devices and want a zero-friction default task app,
 | Voice input | No | Siri |
 | Account required | No | Apple ID for iCloud sync |
 
-Sources: Apple's [Reminders user guide](https://support.apple.com/guide/reminders/welcome/mac) and the [iCloud Reminders web app](https://www.icloud.com/reminders).
+Sources: Apple's [Reminders user guide](https://support.apple.com/guide/reminders/welcome/mac) and [creating and deleting reminders on iCloud.com](https://support.apple.com/en-ie/guide/icloud/mmc0cd77d9/icloud).
 
 ## Where Apple Reminders fits better
 
@@ -49,7 +54,7 @@ Reminders is a strong choice when the goal is "a task manager that just works on
 
 massCode is a strong choice when Reminders' Apple-only constraint is a problem, or when the "task" is really a working note that needs a structured status.
 
-- **You work across operating systems.** massCode runs natively on macOS, Windows, and Linux from the same vault. Reminders has no native Windows or Linux app — only view-only web access through iCloud.com.
+- **You work across operating systems.** massCode runs natively on macOS, Windows, and Linux from the same vault. Reminders has no native Windows or Linux app — web access through iCloud.com, including creating and completing reminders.
 - **You want plain Markdown files on disk.** Every task is a `.md` file with frontmatter in your [Markdown Vault](/documentation/storage). Reminders data lives in Apple's database and is accessed through Apple's apps.
 - **You want one workspace, not five apps.** Tasks share the app with [Code](/documentation/code/library), [Notes](/documentation/notes/), [HTTP](/documentation/http/), [Math](/documentation/math/), [Drawings](/documentation/drawings/), and [Tools](/documentation/tools/).
 - **You want sync without Apple.** Point [iCloud, Dropbox, Google Drive, Syncthing, or Git](/documentation/sync) at your vault. iCloud is one option among many, not the only one.
@@ -75,3 +80,8 @@ massCode is a strong choice when Reminders' Apple-only constraint is a problem,
 You can keep Reminders for life logistics — groceries, family lists, time-and-location alerts — and use massCode tasks for technical work-in-progress, where the "task" is really a working note with code, links, and context.
 
 [Download massCode](/download/) and try it on a few in-flight work notes.
+
+## Related comparisons
+
+- [Markdown-first tasks for developers](/compare/markdown-first-tasks)
+- [massCode vs Obsidian Tasks](/compare/obsidian-tasks)