diff --git a/README.md b/README.md
index bb8547f..499b409 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,29 @@
-# www-site
+# Apache Foundation Website (www.apache.org)
+
+- [Production Website](https://www.apache.org/)
+- [Staged Website](https://www.staged.apache.org/)
+
+This repository provides the website and source code for Apache Petri.
+
+- [Content](content)
+  - *.md* pages in GitHub Flavored Markdown which can include HTML.
+  - *.ezmd* pages in a combination of [ezt](https://github.com/gstein/ezt/blob/wiki/Syntax.md) and GitHub Flavored Markdown.
+  - *.html* files are treated as static files.
+  - static assets of all types.
+  - .htaccess files for redirection and rewrite rules.
+
+- [Issues](https://github.com/apache/www-site/issues)
+- [Branches](https://github.com/apache/www-site/branches)
+- [Pull Requests](https://github.com/apache/www-site/pulls)
+
+The website is built with [Pelican](https://blog.getpelican.com).
+CI/CD is via a [.asf.yaml file](https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features).
+
+- [Base Template](theme/apache/templates/base.html) -- single html skeleton
+- [Templates](theme/apache/templates) -- see the full template folder
+- [Custom Plugins](theme/plugins) -- site data and page processing
+- [Pelican Configuration](pelicanconf.py) -- pelican configuration
+- [ASF data load](asfdata.yaml) -- ASF metadata to be used by ezt and pelican. See [asfdata.py](theme/plugins/asfdata.py)
+- [ASF YAML build](.asf.yaml) -- ASF infrastructure instructions
+
+See the [Developer Guide](DEVELOPER.md) for details about GitHub actions, frameworks, and other tooling.