[wip] Update all docs

Author: salkinium

CONTRIBUTING.md

@@ -13,14 +13,15 @@ We recommend prefixing your branch with
 - `fix/` for a bug fix.
 
 Please remember to have a look at [our coding conventions](docs/coding_convention.md).
+Note that we have a `.clang-format` in the repository that can help you.
 
 Once you [open the pull request][pulls], we will review it and might ask you for
-changes. Remember that you can continue to push to your `feature/*` or `fix/*` 
+changes. Remember that you can continue to push to your `feature/*` or `fix/*`
 branches to update the corresponding pull requests!
 
 Including unit tests is very welcomed and highly recommended. modm has its own
 simple and easy to use unit test framework. Unit tests are placed in the `modm/test`
-subdirectory. [See testing strategies in modm](docs/TESTING.md).
+subdirectory. [See testing strategies in modm](test/README.md).
 
 The CI first compiles all examples and unittests and then executes the unittests
 for Linux. If all of that passes, it will compile all `:platform:**` modules for
@@ -30,13 +31,13 @@ CI tests in order to be merged.
 
 ## When in doubt, ask
 
-The dedicated maintainer of modm is [@salkinium](https://github.com/salkinium)
-and you can always ping him.
+The dedicated maintainers of modm are [@salkinium](https://github.com/salkinium)
+and [@rleh](https://github.com/rleh) and you can always ping them.
 
 If you want to add a new platform, or other significant functionality, we
 [ask you to discuss that in an issue first][issues]. We are very open to new
 helping hands, but all of this is still fairly complicated and we want to
-provideyou with tips and additional explanations along the way.
+provide you with tips and additional explanations along the way.
 
 Communication is cheap, implementation is expensive and we don't want to
 frustrate you.

README.md

@@ -13,8 +13,9 @@ process that you can fine-tune to your needs.
 
 <!--webignore-->
 - [This project has a homepage](http://modm.io).<!--/webignore-->
-- Check out our [install instructions][install] and our [getting started guide][guide].
-- Feast your eyes on [lots of working examples][examples].
+- [Install the toolchain][install] and [explore our examples][examples].
+- You can [discover the modm library][discover] in more detail.
+- Easily start your [own completely custom project][custom-project].
 - Our CI checks every contribution for regressions.
 - We care [about testing modm][testing].
 - [API reference is available here][api-docs].
@@ -53,16 +54,16 @@ git clone --recurse-submodules --jobs 8 https://github.com/modm-io/modm.git
 - Build system agnostic: Choose SCons, CMake or use your own.
 - Data-driven, target-specific HAL generation using the lbuild engine.
 - No memory allocations in HAL with very low overall RAM consumption.
-- Highly-configurable modules with sensible defaults and lots of documentation.
-- Cross platform peripheral interfaces incl. bit banging:
+- Highly configurable modules with sensible defaults and lots of documentation.
+- Cross-platform peripheral interfaces incl. bit banging:
     - GPIO and GPIO expanders.
     - ADC and Analog.
     - UART, I<sup>2</sup>C, SPI, CAN.
 - Interfaces and drivers for many external I<sup>2</sup>C and SPI sensors and devices.
 - Debug/logging system with IOStream and printf interface.
 - Lightweight, stackless threads and resumable functions using cooperative multitasking.
 - Functional (partial) libstdc++ implementation for AVRs.
-- Integration of useful third-party software: FreeRTOS, ROSserial, CMSIS-DSP.
+- Integration of useful third-party software: FreeRTOS, ROSserial, CMSIS-DSP, TinyUSB.
 - Useful filter, interpolation and geometric algorithms.
 - Lightweight unit testing system (suitable for AVRs).
 - Hundreds of tests to ensure correct functionality.
@@ -98,9 +99,8 @@ We also use a few targets in everyday development, which are very well tested
 (★★★★★).
 
 We are only a small team of developers and are limited in the amount of targets
-we can support and test in hardware. We have prepared, but currently not finished
-support for STM32F2, STM32L0 and STM32L1. [Open an issue][issues] to ask if your
-specific target is supported out-of-the-box and what you can do if it's not.
+we can support and test in hardware. [Open an issue][issues] to ask if your
+specific target is supported out-of-the-box and what you can do if it is not.
 
 
 ### Boards
@@ -286,7 +286,8 @@ See [CONTRIBUTING.md][contrib] for our contribution guidelines.
 
 <!--authors-->
 The modm project is maintained by
-Niklas Hauser ([\@salkinium](https://github.com/salkinium)) with significant contributions from
+Niklas Hauser ([\@salkinium](https://github.com/salkinium)) and
+Raphael Lehmann ([\@rleh](https://github.com/rleh)) with significant contributions from
 Sascha Schade ([\@strongly-typed](https://github.com/strongly-typed)),
 Fabian Greif ([\@dergraaf](https://github.com/dergraaf)),
 Kevin Läufer ([\@ekiwi](https://github.com/ekiwi)),
@@ -340,16 +341,17 @@ and <!--authorcount-->33<!--/authorcount-->  more contributors.
 [drivers]:         https://github.com/modm-io/modm/tree/develop/src/modm/driver
 [eurobot]:         https://www.eurobot.org/
 [examples]:        https://github.com/modm-io/modm/tree/develop/examples
-[guide]:           https://modm.io/guide/getting-started
+[discover]:        https://modm.io/guide/discover
+[custom-project]:  https://modm.io/guide/custom-project
 [install]:         https://modm.io/guide/installation
 [issues]:          https://github.com/modm-io/modm/issues
 [library-builder]: https://github.com/dergraaf/library-builder
 [modm-devices]:    https://github.com/modm-io/modm-devices
 [porting]:         https://github.com/modm-io/modm/tree/develop/docs/PORTING.md
 [prs]:             https://github.com/modm-io/modm/pulls
 [rca_ev]:          https://www.roboterclub.rwth-aachen.de/
-[reference]:       https://modm.io/reference/api
+[reference]:       https://modm.io/reference/documentation
 [releases]:        https://github.com/modm-io/modm/releases
-[testing]:         https://modm.io/guide/testing
+[testing]:         https://github.com/modm-io/modm/tree/develop/test/README.md
 [api-docs]:        https://docs.modm.io/
 <!--/links-->

docs/mkdocs.yml

@@ -71,9 +71,10 @@ nav:
     - Who we are: who-we-are.md
   - Guide:
     - Installation: guide/installation.md
-    - Exploring Examples: guide/examples.md
-    - Your own Project: guide/new-project.md
-    - Testing: guide/testing.md
+    - Explore Examples: guide/examples.md
+    - Discover modm: guide/discover.md
+    - Your Project: guide/custom-project.md
+    # - Testing: guide/testing.md
   - Reference:
     - Documentation: reference/documentation.md
     - Build Systems: reference/build-systems.md