docs: improve page about contributing

Author: sourcehold

.gitignore

@@ -1,3 +1,7 @@
+# OpenSHC project specific:
+build/
+_build/
+
 # Prerequisites
 *.d
 

CMakePresets.json

@@ -0,0 +1,49 @@
+{
+  "version": 3,
+  "configurePresets": [
+    {
+      "name": "windows-base",
+      "hidden": true,
+      "generator": "Ninja",
+      "binaryDir": "${sourceDir}/out/build/${presetName}",
+      "installDir": "${sourceDir}/out/install/${presetName}",
+      "cacheVariables": {
+        "CMAKE_C_COMPILER": "cl.exe",
+        "CMAKE_CXX_COMPILER": "cl.exe"
+      },
+      "condition": {
+        "type": "equals",
+        "lhs": "${hostSystemName}",
+        "rhs": "Windows"
+      }
+    },
+    {
+      "name": "x86-debug",
+      "displayName": "x86 Debug",
+      "inherits": "windows-base",
+      "architecture": {
+        "value": "x86",
+        "strategy": "external"
+      },
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Debug"
+      }
+    },
+    {
+      "name": "x86-release",
+      "displayName": "x86 Release",
+      "inherits": "x86-debug",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Release"
+      }
+    },
+    {
+      "name": "x86-release-debuginfo",
+      "displayName": "x86 Release (D)",
+      "inherits": "x86-release",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "RelWithDebInfo"
+      }
+    }
+  ]
+}

OpenSHC.cpp

@@ -0,0 +1,13 @@
+
+#include <iostream>
+
+// We turn optimization off to make sure functions mentioned here aren't inlined
+#pragma optimize("", off)
+
+int main(int argc, char** argv)
+{
+	std::cout << "Welcome to OpenSHC!" << std::endl;
+
+// Here we refer to pieces of code that we don't want to have optimized away
+	return 0;
+}

docs/contributing.rst

@@ -5,10 +5,11 @@ Ready to dive in? Here's how you can start contributing to OpenSHC.
 
 1. **Clone the Repository**
 
-   ```bash
+.. code-block:: bash
+
    git clone https://github.com/sourcehold/OpenSHC.git
    cd OpenSHC
-   ```
+
 
 2. **Install Dependencies**
 
@@ -20,16 +21,18 @@ Ready to dive in? Here's how you can start contributing to OpenSHC.
 3. **Build the Project**
 
    Open a prompt and load the MSVC 1400 environment (.bat file)
-   
-   ```bash
+
+.. code-block:: bash
+
    mkdir build && cd build
-   cmake .. -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=%1
+   cmake .. -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=RelWithDebInfo
    nmake
-   ```
 
 4. **Run reccmp**
-   This compares 
-   ```bash
-   reccmp-reccmp --paths "path\to\Stronghold Crusader.exe" build\OpenSHC.dll build\OpenSHC.pdb . %2 %3
-   ```
+   This compares the functions in the dll to those in the original game.
+   
+.. code-block:: bash
+
+   reccmp-reccmp --paths "path\to\Stronghold Crusader.exe" "build\OpenSHC.dll" "build\OpenSHC.pdb" .
+