> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semicola.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Release notes

> Catch up on changes that matter to your account, explore capabilities you may not use yet, and browse the release feed.

Semicola keeps one account-aware release feed. Ask Semi **"What changed since I was last here?"** for
a summary, open **Release notes** (`open_page` with `page: "release_notes"`), or read the feed over
REST.

## Three views

* **For you**: changes for your role (buyer or seller), plus feature changes that affected your
  account or that you have set up.
* **Explore**: recent changes to features that fit your role but aren't part of your setup yet. A
  discovery aid, not a promise that each one fits.
* **Recent updates**: every recent entry for your role.

Semicola remembers how far each person has read in each account. Updates since then are marked
**New**. Opening **For you** moves your read position to the newest update it showed; browsing
**Explore** or **Recent updates** doesn't. When there's something new, Semi offers "What changed
since I was last here?" as a starter prompt.

## Labels

Every update carries the same labels, so a list scans quickly:

* **Significance**: **Fix**, **Improvement**, **Feature** or **Headline**. A classification, not a
  severity.
* **Maturity**, only when it changes how to read the update: **Alpha**, **Beta** or **Retired**.
* **Why it's in your list**: **Changed for you**, **In your setup** or **For all accounts**.

An update with documentation offers **Read guide**.

## Over the API

| Endpoint                            | What it does                                                                                        |
| ----------------------------------- | --------------------------------------------------------------------------------------------------- |
| `GET /api/v2/release-updates`       | The feed. `scope` (`for_you`, `explore` or `all`), optional `since`, `take` (up to 100) and `skip`. |
| `POST /api/v2/release-updates/seen` | Move your read position to `seenThrough` (an ISO time).                                             |

## Not available yet

* Release notes posted to a shared Slack channel.
* **Open feature**, **Open in Semi** and **Show me** guided lessons on an update.