Update README.md

Author: timkicker

README.md

@@ -2,8 +2,8 @@
 
 This is a small service that turns your GitHub notifications into an RSS feed.
 
-You give it a GitHub personal access token.
-It calls the `/notifications` API, filters the data, and serves a clean RSS 2.0 feed that your reader can subscribe to.
+You give it a GitHub personal access token.  
+It calls the `/notifications` API, filters the data, and serves an RSS 2.0 feed that your reader can subscribe to.
 
 ## What it does
 
@@ -16,13 +16,29 @@ It calls the `/notifications` API, filters the data, and serves a clean RSS 2.0
   - `/feed` for the RSS feed
   - `/health` for a simple JSON status
 
-The RSS items look roughly like this:
+Descriptions can be HTML or plain text, depending on config.
 
-- Title: `[owner/repo] Issue or PR title`
-- Link: direct link to the issue, pull request, commit or release
-- Description: reason, type, repo, unread flag and timestamps
+## Example feed item
 
-Descriptions can be HTML or plain text, depending on config.
+In a typical RSS reader a single item might look like this:
+
+**Title**
+
+`[timkicker/podliner] Fix MPV logging path on Linux`
+
+**Body**
+
+```bash
+[mention] [Pull request] 🔔
+Fix MPV logging path on Linux
+
+Repo: timkicker/podliner
+Reason: mention
+Type: Pull request
+Unread: yes
+Repo link: https://github.com/timkicker/podliner
+Updated: 2025-11-14T06:56:00+00:00
+```
 
 ## Quick start with Docker
 
@@ -34,7 +50,7 @@ cp .env.example .env
 
 Edit `.env` and set at least:
 
-```env
+```bash
 GITHUB_TOKEN=ghp_your_token_here
 ```
 
@@ -93,7 +109,7 @@ BIND_ADDR=0.0.0.0
 BIND_PORT=8000
 ```
 
-You can tune this later when you know what kind of notifications you want to see or hide. For many people the defaults should be fine.
+You can adjust this later when you know what kind of notifications you want to see or hide. For many setups the defaults should be fine.
 
 ## Status endpoint
 
@@ -108,7 +124,7 @@ The `/health` endpoint returns a small JSON payload, for example:
 }
 ```
 
-- `ok` means last fetch worked
+- `ok` means the last fetch worked
 - `degraded` means GitHub failed but an older cached feed is still served
 - `error` means there is no valid cache and the last fetch failed