docs: improve readme (#6)

* Improve README clarity and conciseness

Clarify that this repo is a documentation website (not executable code),
add links to mini-swe-agent for the actual implementation, list what the
tutorial covers, and simplify development instructions.

* Update README

Removed tutorial coverage details from README.

* Update readme

Removed the percentage completion detail from the mini-swe-agent link.

Author: Chesars

README.md

@@ -1,90 +1,27 @@
-# Minimal Agent Website
+# Minimal Agent Tutorial
 
-This repository hosts the code for [minimal-agent.com](https://minimal-agent.com), a minimalistic one-page website that teaches you how to build a minimal AI agent for terminal use.
+> Source code for [minimal-agent.com](https://minimal-agent.com) — a tutorial that teaches you how to build an AI coding agent from scratch.
 
-## Structure
+## What is this?
 
-- `docs/index.md` - Main content in Markdown format
-- `docs/stylesheets/` - Custom CSS for the site
-- `mkdocs.yml` - MkDocs configuration
-- `site/` - Generated static website (git-ignored)
+This repo contains the **documentation website** for the Minimal Agent tutorial. It's a static site built with MkDocs that teaches developers how to build a terminal-based AI agent in ~60 lines of Python.
 
-## Building the Site
+**Looking for the actual agent code?**
+- 📦 [mini-swe-agent](https://github.com/SWE-agent/mini-swe-agent) — The full implementation.
+- 📄 [minimal-agent.com](https://minimal-agent.com) — The tutorial (copy-paste code from here)
 
-1. Install dependencies:
-   ```bash
-   pip install -r requirements.txt
-   ```
 
-2. Build the site:
-   ```bash
-   mkdocs build
-   ```
-
-3. The generated site will be in the `site/` directory. Open `site/index.html` in your browser.
-
-## Development Mode
-
-For live development with automatic rebuilding and hot reload:
+## Local development
 
 ```bash
+pip install -r requirements.txt
 mkdocs serve
 ```
 
-This will:
-- Start a local server at `http://localhost:8000`
-- Watch for changes to markdown and configuration files
-- Automatically rebuild and reload the site when files change
-- No need to refresh your browser!
-
-You can specify a custom port:
-
-```bash
-mkdocs serve -a localhost:3000
-```
-
-## Deployment
-
-To deploy to GitHub Pages:
-
-```bash
-mkdocs gh-deploy
-```
+Then open http://localhost:8000
 
-## Markdown Features
+## Contributing
 
-The site uses [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) and supports:
+The tutorial content is in `docs/index.md`. Edit that file and submit a PR.
 
-- Standard Markdown syntax
-- Inline HTML content
-- Code blocks with syntax highlighting and line numbers
-- Admonitions (notes, warnings, etc.)
-- Tabbed content
-- Collapsible sections (details/summary)
-- Dark/light theme toggle
-
-### Example Admonition
-
-Use `!!!` syntax for admonitions:
-
-```markdown
-!!! note "This is a note"
-    This is the content of the note.
-```
-
-### Example Tabbed Content
-
-```markdown
-=== "Tab 1"
-    Content for tab 1
-
-=== "Tab 2"
-    Content for tab 2
-```
-
-### Example Foldout
-
-```markdown
-??? "Click to expand"
-    Hidden content here
-```
+This site uses [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) which supports admonitions, tabs, code highlighting, and more.