code & readme

.gitignore

@@ -1,3 +1,5 @@
+.obsidian/*
+
 # ---> VisualStudioCode
 .vscode/*
 !.vscode/settings.json

README.md

@@ -1,3 +1,66 @@
-# hello
+ls# Install `Golang`
 
-Golang + VsCode
+## Compiler
+
+  Download Golang [installer](https://go.dev/dl/). A least on Mac it shall deal with updating your  OS `PATH` environment variable with  `$GOPATH/bin`.
+  
+## Debugger
+  
+```bash
+go install -v github.com/go-delve/delve/cmd/dlv@latest 
+```
+
+# VsCode IDE
+
+- Install [Visual Studio Code](https://code.visualstudio.com)
+-  `golang` extension
+  To launch *VS Code Quick Open* press (Ctrl + P), type: `ext install Go` ,  hit enter. Follow basic instructions.
+
+# The Project
+
+Inside `Visual Studio Code` Open Folder `Ctrl + Shift + E` , e.g.: `$USER\code\hello\`.  Then Open `hello.go` from that folder. Or make new file (Ctrl + N) and save it on this folder:
+
+```go
+package main
+
+import "fmt"
+
+func main() {
+    fmt.Println("Hello World!")
+    i := 101
+    fmt.Println(i)
+}
+```
+
+Some useful hotkeys:
+- `Ctrl + Shift + D` - Open Debugger
+- `F9` - set or toggle Breakpoint. *Try this line `i := 101`*
+- `F5` - Start Debugging or to Run the Application. If asked to select environment: select `Go`
+- `F10` -  Step Over
+- `F11` - Step Into
+- `Shift + F11` - Step Out
+- `Shift + F5` - Stop Debugging
+-  `Ctrl + Shift + F5` - Restart Debugging
+
+Typical aka untouched `launch.json` :
+
+```json
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Launch",
+            "type": "go",
+            "request": "launch",
+            "mode": "debug",
+            "remotePath": "",
+            "port": 2345,
+            "host": "127.0.0.1",
+            "program": "${workspaceRoot}",
+            "env": {},
+            "args": [],
+            "showLog": true
+        }
+    ]
+}
+```

go.mod

@@ -0,0 +1,3 @@
+module example/hello
+
+go 1.22.2

hello.go

@@ -0,0 +1,9 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("Hello, World!")
+	i := 101
+	fmt.Println(i)
+}