Add doc about how to debug with martin and vscode

docs/src/SUMMARY.md

@@ -39,4 +39,5 @@
   - [Diffing/Patching MBTiles](mbtiles-diff.md)
   - [Validating MBTiles](mbtiles-validation.md)
 - [Development](development.md)
+  - [Getting involved](getting-involved.md)
   - [Martin as a library](martin-as-a-library.md)

docs/src/getting-involved.md

@@ -0,0 +1,114 @@
+# Getting involved
+
+It's time to get involved once you have the [fork and all required software](development.md).
+
+We assume you are working on Ubuntu (or WSL) with Visual Studio Code in this post.
+
+## Editor Plugins
+
+Install plugins below:
+* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb)
+* [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
+
+## Debugging with `launch.json`
+
+Generally, you need to debug martin with specific arguments or a config file to fix issues or add features.
+
+The most convenient way is to generate a launch.json and modify it.
+
+## Generate
+
+Press `F1` on your keyboard, and input "Generate Launch Configurations from Cargo.toml". Execute it and save it to your `.vscode` directory.
+
+## Modify 
+
+Let's say you want to debugging Martin with this command:
+```shell
+martin postgres://postgres:postgres@localhost:5411/db --default-srid 4490
+```
+
+You could find `Debug executable 'martin'` in your `launch.json`, like below:
+```json
+        {
+            "type": "lldb",
+            "request": "launch",
+            "name": "Debug executable 'martin'",
+            "cargo": {
+                "args": [
+                    "build",
+                    "--bin=martin",
+                    "--package=martin"
+                ],
+                "filter": {
+                    "name": "martin",
+                    "kind": "bin"
+                }
+            },
+            "args": [],
+            "cwd": "${workspaceFolder}"
+        },
+```
+
+Just copy and paste after it, and modify your pasted like this:
+
+```json
+        {
+            "type": "lldb",
+            "request": "launch",
+            "name": "my first debug", // name it any as you like 
+            "cargo": {
+                "args": [
+                    "build",
+                    "--bin=martin",
+                    "--package=martin"
+                ],
+                "filter": {
+                    "name": "martin",
+                    "kind": "bin"
+                }
+            },
+            "args": ["postgres://postgres:postgres@localhost:5411/db"], // add your arguments here
+             "env": {
+                 "DEFAULT_SRID": 4490, // add your env here
+             },
+            "cwd": "${workspaceFolder}"
+        },
+```
+
+### Add a breakpoint
+
+Go to any part you're interested in of martin code and add a breakpoint.
+
+We add a breakpoint here in the [start of martin](https://github.com/maplibre/martin/blob/e628c3973f193a432d3d1282c5893e2339e806b6/martin/src/bin/martin.rs#L10).
+
+```rust
+use clap::Parser;
+use log::{error, info, log_enabled};
+use martin::args::{Args, OsEnv};
+use martin::srv::new_server;
+use martin::{read_config, Config, MartinResult};
+
+const VERSION: &str = env!("CARGO_PKG_VERSION");
+
+async fn start(args: Args) -> MartinResult<()> {
+    info!("Starting Martin v{VERSION}");
+```
+
+### Debugging
+
+Click `Run and Debug` on the left panel of `Visual Studio Code`. Choose `my first debug` and press `F5` on your keyboard.
+
+Wait for the breakpoint to be hit.
+
+
+## Working with Just
+
+
+//todo
+
+
+
+
+
+
+