updated docs
diff --git a/doc/html_generated/readme.html b/doc/html_generated/readme.html
index c0e0e79..0ccc25e 100644
--- a/doc/html_generated/readme.html
+++ b/doc/html_generated/readme.html
@@ -6,13 +6,14 @@
 Reference
 =======
 
+Project:
+
 - [Features and design goals](features.html) - the complete list of features
 - [Roadmap](roadmap.html) - upcoming features
 - [Benchmarks](benchmarks.html) - compile time supremacy
-- [Contributing](contributing.html)
-- [Examples](../../examples)
+- [Contributing](contributing.html) - how to make a proper pull request
 
--------------
+Usage:
 
 - [Tutorial](tutorial.html) - make sure you have read it before the other parts of the documentation
 - [Assertion macros](assertions.html)
@@ -22,6 +23,7 @@
 - [Configuration](configuration.html)
 - [String conversions](stringification.html)
 - [FAQ](faq.html)
+- [Examples](../../examples)
 
 Support the development of the project with donations! There is a list of planned features which are all important and big - see the [**roadmap**](roadmap.html). I took a break from working in the industry to make open source software so every cent is a big deal.
 
diff --git a/doc/html_generated/roadmap.html b/doc/html_generated/roadmap.html
index 6ac427a..1c6dfaf 100644
--- a/doc/html_generated/roadmap.html
+++ b/doc/html_generated/roadmap.html
@@ -53,7 +53,7 @@
     - https://msdn.microsoft.com/en-us/library/hh270865.aspx
     - https://msdn.microsoft.com/en-us/library/hh598953.aspx
     - also look into similar Xcode integration - https://github.com/philsquared/Catch/pull/454
-- matchers - should investigate what they are
+- matchers - should investigate what they are - look at google test and Catch
 - generators? - look at Catch - and investigate what they are (also in [boost](http://www.boost.org/doc/libs/1_61_0/libs/test/doc/html/boost_test/tests_organization/test_cases/test_case_generation.html))
 - mocking - investigate google mock assertion macros and interop with doctest (also [mockitopp](https://github.com/tpounds/mockitopp) and [trompeloeil](https://github.com/rollbear/trompeloeil)) - and write in FAQ
 - look at property based testing (for example [rapidcheck](https://github.com/emil-e/rapidcheck)) - and write in FAQ
diff --git a/doc/markdown/readme.md b/doc/markdown/readme.md
index c79ccb1..da878c6 100644
--- a/doc/markdown/readme.md
+++ b/doc/markdown/readme.md
@@ -1,13 +1,14 @@
 Reference
 =======
 
+Project:
+
 - [Features and design goals](features.md) - the complete list of features
 - [Roadmap](roadmap.md) - upcoming features
 - [Benchmarks](benchmarks.md) - compile time supremacy
-- [Contributing](contributing.md)
-- [Examples](../../examples)
+- [Contributing](contributing.md) - how to make a proper pull request
 
--------------
+Usage:
 
 - [Tutorial](tutorial.md) - make sure you have read it before the other parts of the documentation
 - [Assertion macros](assertions.md)
@@ -17,6 +18,7 @@
 - [Configuration](configuration.md)
 - [String conversions](stringification.md)
 - [FAQ](faq.md)
+- [Examples](../../examples)
 
 Support the development of the project with donations! There is a list of planned features which are all important and big - see the [**roadmap**](roadmap.md). I took a break from working in the industry to make open source software so every cent is a big deal.
 
diff --git a/doc/markdown/roadmap.md b/doc/markdown/roadmap.md
index c9cf09a..bced7ff 100644
--- a/doc/markdown/roadmap.md
+++ b/doc/markdown/roadmap.md
@@ -48,7 +48,7 @@
     - https://msdn.microsoft.com/en-us/library/hh270865.aspx
     - https://msdn.microsoft.com/en-us/library/hh598953.aspx
     - also look into similar Xcode integration - https://github.com/philsquared/Catch/pull/454
-- matchers - should investigate what they are
+- matchers - should investigate what they are - look at google test and Catch
 - generators? - look at Catch - and investigate what they are (also in [boost](http://www.boost.org/doc/libs/1_61_0/libs/test/doc/html/boost_test/tests_organization/test_cases/test_case_generation.html))
 - mocking - investigate google mock assertion macros and interop with doctest (also [mockitopp](https://github.com/tpounds/mockitopp) and [trompeloeil](https://github.com/rollbear/trompeloeil)) - and write in FAQ
 - look at property based testing (for example [rapidcheck](https://github.com/emil-e/rapidcheck)) - and write in FAQ