diff --git a/gen_c11/Readme.md b/gen_c11/Readme.md
index 9e6d49d..94fccbb 100644
--- a/gen_c11/Readme.md
+++ b/gen_c11/Readme.md
@@ -1,3 +1,21 @@
 # gen_c11
 
+[gen_c11.c](./gen_c11.c) generates both *segregated* and *single-header* varients of the metadesk library utilizing [gencpp_c11](../third_party/gencpp_c11/).
 
+Generated content will be place in a subdirectory called `/gen`.
+
+[gen_common.h](./gen_common.h) contains implementation that will eventually be utilized by [gen_cpp17](../gen_cpp17/).
+
+The prefix `md_` or `MD_` (depending on type of symbol) will be prepended to the symbols of the library using [refactor.exe](../bin/refactor.exe) which is from the [refactor repo](https://github.com/Ed94/refactor).
+
+[c11.refactor](./c11.refactor) is the script defining all the rename mappings
+
+[.clang_format](../bin/.clang_format) is used to cleanup library's formatting on some files post-refactor.
+
+The generation takes a few seconds due to how slow both clang-format and refactor.exe are. Eventually I wish to make refactor a c11 library to offset it that problem but I don't have a good solution to clang_format yet.
+
+If using the powershell script [build.ps1](../bin/build.ps1); Use the following command:
+
+```ps1
+.\build gen_c11 <debug> <msvc>
+```
diff --git a/gen_cpp17/Readme.md b/gen_cpp17/Readme.md
index 4365c8b..7c817c5 100644
--- a/gen_cpp17/Readme.md
+++ b/gen_cpp17/Readme.md
@@ -1,3 +1,5 @@
 # gen_cpp17
 
+Eventually this will generate a more ergonomic version of metadesk for C++17 usage.
 
+For now however the goal is just to get the c11 library variants working with the old tests and exmaples.