diff --git a/README.md b/README.md
index 11d4f69..5e82af3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,19 @@
+
+- [What this is](#what-this-is)
+ - [Experience as a taxonomy](#experience-as-a-taxonomy)
+- [Tech](#tech)
+- [Commands](#commands)
+- [Content](#content)
+ - [Projects (`src/content/projects`)](#projects-srccontentprojects)
+ - [Experience (`src/content/experience`)](#experience-srccontentexperience)
+ - [Writing (`src/content/writing`)](#writing-srccontentwriting)
+ - [Speaking (`src/content/speaking`)](#speaking-srccontentspeaking)
+- [Configure](#configure)
+- [Deploy](#deploy)
+- [Acknowledgment](#acknowledgment)
+- [License](#license)
+
+
@@ -49,11 +65,12 @@ Content lives in `src/content/` as `.md`/`.mdx` files; the filename
| Property | Required | Notes |
| --------------- | :------: | -------------------------------------------------- |
| `title` | ✓ | Max 60 chars. |
-| `publishDate` | ✓ | ISO 8601 (offsets allowed). |
+| `startDate` | ✓ | Date. |
+| `endDate` | | Omit for ongoing projects. Projects are sorted by `endDate`, most recent first (ongoing on top). |
| `description` | | Used for meta description. |
| `link` | | URL to the live project. |
| `repo` | | URL to the source repository. |
-| `tags` | | String array. |
+| `tags` | | Skills/technologies — double as tags for cross-project browsing at `/projects/tags/`. |
| `experiences` | | Array of experience ids this project is filed under. |
### Experience (`src/content/experience`)