diff --git a/README.md b/README.md
index 5686262..e4b2f9d 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-# Specifications of datastructures, interfaces, and file formats
+# Specifications for datastructures, interfaces, and file formats
 
 * **Generic datastructure specifications**: To be used in applications, as payloads in apis, or as file formats.
-* **API Interfaces offered by ClusterCockpit**
-* **HPC Job-Archive specification**
-* **SQL Jobs Table Schema** 
+* **APIs offered by ClusterCockpit**: REST, GraphQL, and Influx Line protocol descriptions.
+* **HPC Job-Archive specification**: A directory tree and file format description for a file based HPC Job Performance archive.
+* **SQL Jobs Table Schema**: The SQL database schema used in cc-backend.