add page on debugging

Author: zamronidomino

debugging/index.md

@@ -0,0 +1,63 @@
+---
+title: Debugging
+description: Debugging Fano Framework web application
+---
+
+<h1 class="major">Debugging</h1>
+
+This section explains how to debug Fano Framework web application. This document assumes that you know how to create Fano Framework web application project. If you do not, you should read [Getting Started](/getting-started) document first.
+
+## Debugging in Visual Studio Code IDE
+
+### Install NativeDebug extension
+
+We will install [Native Debug](https://github.com/WebFreak001/code-debug) extension to debug in Visual Studio Code with GDB debugger. Installation process is straightforward. Press `Ctrl + Shift + X` keyboard shortcut to open *Extensions* tab. Type *Native Debug* to search extension and click *Install* button. Wait until installation is complete.
+
+### Create launch.json file
+
+Open Run tab (`Ctrl + Shift + D`) click *Run and Debug* button and select GDB environment.
+Visual Studio Code will create `launch.json` file. Replace `name` and `target` like so
+
+```
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Fano",
+            "type": "gdb",
+            "request": "launch",
+            "target": "./bin/app.cgi",
+            "cwd": "${workspaceRoot}",
+            "valuesFormatting": "parseText"
+        }
+    ]
+}
+```
+Save and close it.
+
+Now when you open *Run* tab (`Ctrl + Shift + D`) you will see *Debug Fano* on top.
+
+### Build executable for development
+
+To be able to debug, we need debugging information inside executable binary. Go to
+shell and from inside project root directory, run
+
+```
+$ ./tools/clean.sh
+$ BUILD_TYPE=dev ./build.sh
+```
+
+This will compile Fano Framework web application with debugging information.
+
+### Start debugging
+
+Back to Visual Studio Code IDE. Open source code file you want to debug and toggle breakpoint at line of interest by clicking on empty area left of line number. Activate *Run* tab click green button on left of *Debug Fano* to start debugging.
+
+## Debugging in Lazarus IDE
+
+*TODO*
+
+## Explore more
+
+- [Getting started](/getting-started)
+- [Step-By-Step Tutorials](/tutorials)

documentation/index.md

@@ -67,6 +67,10 @@ description: Documentation and developer's resources for Fano Framework, web app
 - [Deploy as http application](/deployment/standalone-web-server)
 - [Deploy Fano web application with web server as load balancer](/deployment/load-balancer-setup)
 
+## Debugging
+
+- [Debugging](/debugging)
+
 ## Known Issue
 - [Issue with GNU Linker](/known-issues#issue-with-gnu-linker)
 - [Issue with development tools library search path](/known-issues#issue-with-gcc-library-search-path)