diff --git a/README.md b/README.md
index b76ff365..5f7297c5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
-# Prerequisites
+# Jakarta Pages
 
-Java 11
+This repository contains the code for Jakarta Pages.
+
+[Online JavaDoc](https://javadoc.io/doc/jakarta.servlet.jsp/jakarta.servlet.jsp-api/)
+
+Note that this concerns the API only. An implementation is needed in addition to this.
+
+
+Building
+--------
+
+Jakarta Pages can be built by executing the following from the project root:
+
+``mvn clean package``
+
+The API jar can then be found in /api/target and the specification document in /spec/target.
+
+Making Changes
+--------------
+
+To make changes, fork this repository, make your changes, and submit a pull request.
+
+About Jakarta Pages
+-------------
+
+Jakarta Pages defines a template engine for web applications.
+
+Implementations
+-------------
+
+* [Eclipse WaSP](https://github.com/eclipse-ee4j/wasp)
+* [Tomcat Jasper](https://tomcat.apache.org/tomcat-10.0-doc/jasper-howto.html)