diff --git a/configuration-sample/README.md b/configuration-sample/README.md
index 9cd14515..e1847b48 100644
--- a/configuration-sample/README.md
+++ b/configuration-sample/README.md
@@ -1,3 +1,14 @@
+# Configuration Sample Extension
+
+This sample shows
+
+- How to define a `window` and `resource` scoped configurations.
+- How to read and update a `window` scoped configuration
+- How to read a `resource` scoped configuration of a resource
+- How to update a value for `resource` scoped configuration of a resource
+- How to listen to configuration changes
+- How to test it
+
 # Testing
 
 ## Empty Workspace