diff --git a/03-code-generation/README.adoc b/03-code-generation/README.adoc
index be92eb0..92f495b 100644
--- a/03-code-generation/README.adoc
+++ b/03-code-generation/README.adoc
@@ -1,3 +1,8 @@
-Examples showing code generation using various tools.
+= Code Generation
 
-Also shows how to move variables from CMAKE into source files (configure_file).
\ No newline at end of file
+Code generation can be useful to create source code in different languages from a common description file. This can reduce the amount of manual code to write and increase inter-operability.
+
+Examples showing code generation using variables from CMake and also using some common tools.
+
+  * link:configure-files[configure-file] - Using the CMake configure_file function to inject CMake variables.
+  * link:protobuf[Protocol Buffers] - Using Google Protocol Buffers to generate C++ source.