Merge pull request #21730 from LasseRosenow/guides-replace-screenshots-with-code

doc/guides: improve guides and many small fixes

Author: crasbe

CODE_OF_CONDUCT.md

@@ -15,12 +15,12 @@ We rather would like you to think of it as a guide to enrich our community and
 the technical community in general with new knowledge and perspectives by
 allowing everyone to participate.
 
-This code of conduct applies to all spaces managed by the RIOT community. This
+This Code of Conduct applies to all spaces managed by the RIOT community. This
 includes any communication within the RIOT community, both online and face to
 face. In addition, violations of this code outside these spaces may also
 affect a person's ability to participate within them.
 
-If you believe someone is violating the code of conduct, we ask that you report
+If you believe someone is violating the Code of Conduct, we ask that you report
 it by emailing <[email protected]>. For more details please see our [Reporting
 Guidelines][reporting-guidelines].
 

CODING_CONVENTIONS_C++.md

@@ -1,12 +1,15 @@
-You should check out the [C Conventions](CODING_CONVENTIONS.md) as some section
+# Coding Conventions C++
+
+You should check out the [C Conventions] as some section
 still apply (Documentation, Git, Travis).
 
 When contributing source code, please adhere to the following coding style,
 which is loosely based on the [Google C++ Style Guide] and the coding
  conventions used by the C++ Standard Library. Based on the [CAF coding style].
 
-[Google C++ Style Guide]: (https://google.github.io/styleguide/cppguide.html)
-[CAF coding style]: (https://github.com/actor-framework/actor-framework/blob/master/CONTRIBUTING.md)
+[C Conventions]: https://guide.riot-os.org/c_tutorials/coding_conventions/
+[Google C++ Style Guide]: https://google.github.io/styleguide/cppguide.html
+[CAF coding style]: https://github.com/actor-framework/actor-framework/blob/master/CONTRIBUTING.md
 
 ## Example for the Impatient
 
@@ -233,7 +236,6 @@ void my_class::do_something_else() {
   }
   ```
 
-
 ## Headers
 
 - Each `.cpp` file has an associated `.hpp` file.
@@ -258,7 +260,6 @@ void my_class::do_something_else() {
 
 - Use `inline` for small functions (rule of thumb: 10 lines or less).
 
-
 ## Breaking Statements
 
 - Break constructor initializers after the comma, use four spaces for
@@ -295,7 +296,6 @@ void my_class::do_something_else() {
   }
   ```
 
-
 ## Template Metaprogramming
 
 Despite its power, template metaprogramming came to the language pretty
@@ -340,15 +340,13 @@ extra rules for formatting metaprogramming code.
                                                ResponseHandleTag>;
   ```
 
-
 ## Preprocessor Macros
 
 - Use macros if and only if you can't get the same result by using inline
   functions or proper constants.
 
 - Macro names use the form `RIOT_<COMPONENT>_<NAME>`.
 
-
 ## Comments
 
 - Doxygen comments start with `///`.

GOVERNANCE.md

@@ -257,9 +257,9 @@ Computing Foundation (CNCF).
 [contributing guidelines]: https://github.com/RIOT-OS/RIOT/blob/master/CONTRIBUTING.md
 [maintainers list]: https://riot-os.org/maintainers.html
 [maintainers GitHub team]: https://github.com/orgs/RIOT-OS/teams/maintainers
-[managing a release]: https://github.com/RIOT-OS/RIOT/blob/master/doc/guides/managing-a-release/README.md
+[managing a release]: https://guide.riot-os.org/misc/managing-a-release/
 [maintaining guidelines]: https://github.com/RIOT-OS/RIOT/blob/master/MAINTAINING.md
-[Code of Conduct]: https://github.com/RIOT-OS/RIOT/blob/master/CODE_OF_CONDUCT.md
-[Code of Conduct reporting guidance]: https://doc.riot-os.org/coc-reporting-guide.html
+[Code of Conduct]: https://guide.riot-os.org/general/code_of_conduct/
+[Code of Conduct reporting guidance]: https://guide.riot-os.org/general/code_of_conduct/reporting/
 [security policy]: https://github.com/RIOT-OS/RIOT/blob/master/SECURITY.md
 [GOVERNANCE-maintainer.md template]: https://github.com/cncf/project-template/blob/main/GOVERNANCE-maintainer.md