Update README.md

Author: tschaffter

README.md

@@ -31,6 +31,17 @@ one repository. This reposiutory can then be added as a Git submodule to
 multiple repositories that will then benefit from the same tools and
 configurations.
 
+## Requirements
+
+The following programs must be installed before using the tools provided by the
+repository.
+
+- [cmake-format](https://github.com/cheshirekow/cmake_format)
+- [cmake-lint](https://github.com/cheshirekow/cmake_format)
+- [clang-format](https://github.com/llvm-mirror/clang/tree/master/tools/clang-format)
+
+An example of how to install these programs is given in this [Dockerfile](https://github.com/tschaffter/cxx-ci.git)
+
 ## Usage
 
 If you want to use the tool versions and configurations defined in this
@@ -123,14 +134,23 @@ in this repository. The CML interface is the same as `cxxdt-cmake-lint`.
 
 ## GitHub tools
 
-- [pre-commit hook](git/.githooks/pre-commit) - Checks
-that your `.circleci/config.yml` is valid, otherwise `git commit` fails.
+- .githook/pre-commit - Validates `.circleci/config.yml`
+before acceptiing a commit.
 
 ## Continuous Integration
 
 An example of integration of `cxx-dev-tools` into a CI configuration is
 available in `.circleci/config.yml`.
 
+## Related Open Source Projects
+
+Projects | Description
+----------|--------------|
+[tschaffter/cxx-ci](https://github.com/tschaffter/cxx-ci.git) | CXX build and test environment
+[tschaffter/cxx-ci](https://github.com/tschaffter/esp-idf-ci.git) | ESP-IDF build and test environment
+
+[tschaffter/cxx-ci - 
+
 ## Contributing change
 
 Please read the [`CONTRIBUTING.md`](CONTRIBUTING.md) for details on how to contribute to this project.

cmake/README.md

@@ -0,0 +1,19 @@
+# Developing with CMake
+
+## Tools
+
+- cxxdt-cmake-lint
+- cxxdt-cmake-format
+
+These tools use the following configurations:
+
+- config/.cmake-format.json - Default configuration generated using `cmake-format`.
+- config/.esp-idf-cmake-format.json - Configuration for linting ESP-IDF CMake
+files.
+
+See the project [README.md](../README.md) for more detailed information on how
+to use these tools.
+
+## CMake modules
+
+- BuildType.cmake - Set a default build type if none was specified.

cxx/README.md

@@ -0,0 +1,13 @@
+# CXX Development
+
+## Tools
+
+- cxxdt-cxx-lint
+- cxxdt-cxx-format
+
+These tools use the following configuration:
+
+- config/.clang-format
+
+See the project [README.md](../README.md) for more detailed information on how
+to use these tools.

git/README.md

@@ -1,4 +1,9 @@
-## Set Git hooks directory
+# Developing with Git
+
+## Git hooks
+
+- .githooks/pre-commit - Validates `.circleci/config.yml` before acceptiing a
+commit.
 
 ```
 git config core.hooksPath .githooks