From 397bb8b3afcaf4037f0e1998d019e3dcdf660477 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <stevan.freeborn@gmail.com>
Date: Wed, 8 Jul 2026 08:35:52 -0500
Subject: [PATCH] docs: add README.md and license

---
 LICENSE.md | 19 +++++++++++++++
 README.md  | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 LICENSE.md

diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..307cc61
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,19 @@
+# Copyright (c) 2026 Stevan Freeborn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 898e398..f1e509c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,72 @@
 # Tolkien Fan Club
 
+A static site generator that converts Markdown content into HTML pages. Built from scratch as a learning exercise for [boot.dev](https://boot.dev).
+
+## Usage
+
+```bash
+# Build and serve locally
+./main.sh
+
+# Build with GitHub Pages basepath
+./build.sh
+
+# Run tests
+./test.sh
+```
+
+Or directly:
+
+```bash
+python3 -m src <destination> <basepath>
+python3 -m src "public" "/"
+python3 -m src "docs" "/tolkien-fan-club/"
+```
+
+## Project Structure
+
+```
+├── content/              # Markdown source files
+├── static/               # Static assets (CSS, images)
+├── template.html         # HTML template with {{ Title }} and {{ Content }}
+├── src/
+│   ├── cli.py            # Entry point
+│   ├── copier.py         # Static file copying
+│   ├── generator.py      # Page generation orchestration
+│   ├── template.py       # Template rendering + title extraction
+│   ├── nodes/
+│   │   ├── html.py       # HtmlNode base class
+│   │   ├── leaf.py       # LeafNode (void/self-closing elements)
+│   │   ├── parent.py     # ParentNode (nested elements)
+│   │   └── text.py       # TextNode / TextType + conversion to HTML
+│   ├── markdown/
+│   │   ├── blocks.py     # Block-level parsing (headings, code, lists, etc.)
+│   │   ├── extract.py    # Regex extraction for images and links
+│   │   ├── inlines.py    # Inline parsing (bold, italic, code, images, links)
+│   │   └── to_html.py    # Markdown → HTML conversion + block handlers
+│   └── tests/            # Test suite (48 tests)
+├── main.sh               # Build + serve locally
+├── build.sh              # Build for GitHub Pages
+└── test.sh               # Run test suite
+```
+
+## Pipeline
+
+```
+Markdown → blocks → block-type detection → inline parsing → TextNodes → HTML nodes → template injection
+```
+
+## Requirements
+
+- Python 3.13+
+- No external dependencies
+
+## Tests
+
+```bash
+python3 -m unittest discover -s src/tests -v
+```
+
+## License
+
+MIT