mixc

README.md

@@ -54,6 +54,35 @@ npm run check     # Astro + TypeScript check
 - **Matomo.** The privacy page links to the existing opt-out on `cipher.uber.space`. The tracking
   snippet itself is not included; add it in `src/layouts/Base.astro` if analytics should continue.
 
+## Insights filter
+
+The Insights index can be filtered by type: Essays (posts), LinkedIn (mentions with
+`platform: 'LinkedIn'`) and Other (mentions from any other platform). A filter only appears once it
+has an entry, and the bar only when there are at least two types. The choice is kept in
+`?type=essay|linkedin|other`, so a filtered view can be linked. The types are in `src/data/insights.ts`.
+
+## Adding a mention
+
+A mention is a short pointer to a post elsewhere (LinkedIn) that CipherCell took part in. It appears
+in the Insights list and on the home page, sorted by date with the essays, and has a short page at
+`/insights/<slug>`: headline, summary, a link out, and the post embedded on request. The embed is
+two-click: nothing loads from LinkedIn until the visitor presses the button (see the privacy page).
+The embed URL is derived from a LinkedIn post link; set `embed` by hand only if that fails, and
+`embedHeight` (pixels, default 720) if the post is cut off or leaves a gap. Text below the front
+matter is shown as our own notes. A slug used by both an essay and a mention fails the build. Create `src/content/mentions/<slug>.md` with front matter only:
+
+```yaml
+title: 'Component security testing at the xG-ALOE Plugfest 2026.'   # our headline, sentence case
+summary: 'One or two sentences in our words on what the post says.'
+url: 'https://www.linkedin.com/posts/...'   # paste the share link; query and fragment are stripped
+source: 'xG-ALOE'                           # who posted it
+platform: 'LinkedIn'                        # optional, defaults to LinkedIn
+date: 2026-09-17                            # the post's publication date
+lang: en                                    # language of the post itself
+```
+
+Summarise only what the post says.
+
 ## Adding a post
 
 Create `src/content/insights/<slug>.md` with the front matter used in `xg-aloe-user-forum.md`.