diff --git a/README.md b/README.md
new file mode 100644
index 0000000..96d78fe
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+## Pact Example
+
+This repository contains code examples for these two blog posts:
+
+- [Consumer Driven Contracts with Pact (Part 1)](https://reinhard.codes/2022/12/21/consumer-driven-contracts-with-pact/)
+- [Pact part 2: Sharing contracts with the Pact Broker](https://reinhard.codes/2023/01/02/sharing-contracts-with-pact-broker/)
+
+You you have suggestions, find inconsistencies, gaps or errors please provide feedback on [Mastodon](https://hachyderm.io/@ryan_harg).