Split instruction how to build souce code and run website (#1234)

Author: pascalberger

docs/input/documentation/contributing/how-to-build-addins.md

@@ -0,0 +1,38 @@
+---
+title: How to build addins
+description: Instructions how to build individual Cake Issues addins.
+---
+
+Ensure the following prerequisites are fulfilled:
+
+* Latest .NET version installed
+
+To build the addins and run unit tests [Cake]{target="_blank"} is used:
+
+=== ":material-microsoft-windows: Windows"
+
+    ```powershell
+    .\build.ps1
+    ```
+
+=== ":material-apple: macOS"
+
+    ```bash
+    ./build.sh
+    ```
+
+=== ":material-linux: Linux"
+
+    ```bash
+    ./build.sh
+    ```
+
+To run only part of the build a task can be passed using the `--target=<TASK>` syntax:
+
+| Task                    | Description                                                                                                                          |
+|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
+| `DotNetCore-Build`      | Builds all addins                                                                                                                    |
+| `Create-NuGet-Packages` | Builds and creates NuGet packages for all addins. The NuGet packages are available in the `BuildArtifacts\Packages\NuGet` directory. |
+| `Test`                  | Builds all addins and runs unit tests. Coverage report is available in the `BuildArtifacts\TestCoverage` directory.                  |
+
+[Cake]: https://cakebuild.net/

docs/input/documentation/contributing/how-to-build.md renamed to docs/input/documentation/contributing/how-to-run-website.md

@@ -1,44 +1,8 @@
 ---
-title: How to build addins
-description: Instructions how to build individual Cake Issues addins.
+title: How to build and run website
+description: Instructions how to build and run website locally
 ---
 
-## Building addins
-
-Ensure the following prerequisites are fulfilled:
-
-* Latest .NET version installed
-
-To build the addins and run unit tests [Cake]{target="_blank"} is used:
-
-=== ":material-microsoft-windows: Windows"
-
-    ```powershell
-    .\build.ps1
-    ```
-
-=== ":material-apple: macOS"
-
-    ```bash
-    ./build.sh
-    ```
-
-=== ":material-linux: Linux"
-
-    ```bash
-    ./build.sh
-    ```
-
-To run only part of the build a task can be passed using the `--target=<TASK>` syntax:
-
-| Task                    | Description                                                                                                                         |
-|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
-| `DotNetCore-Build`      | Builds all addins                                                                                                                   |
-| `Create-NuGet-Packages` | Builds an creates NuGet packages for all addins. The NuGet packages are available in the `BuildArtifacts\Packages\NuGet` directory. |
-| `Test`                  | Builds all addins and runs unit tests. Coverage report is available in the `BuildArtifacts\TestCoverage` directory.                 |
-
-## Building and running website locally
-
 === "Running in GitHub Codespaces"
 
     Website can be built and run in [GitHub Codespaces]{target="_blank"}.

docs/mkdocs.yml

@@ -325,7 +325,8 @@ nav:
       - Contributing:
         - How To Contribute: documentation/contributing/how-to-contribute.md
         - Open issues: https://github.com/cake-contrib/Cake.Issues/issues" target="_blank
-        - Building Source Code: documentation/contributing/how-to-build.md
+        - Building addins: documentation/contributing/how-to-build-addins.md
+        - Running website: documentation/contributing/how-to-run-website.md
       - Maintainer Guide:
         - Performing Release: documentation/contributing/how-to-release.md
     - Resources: