docs: update development guide and issue report instructions for clarity

Author: dido18

Taskfile.yml

@@ -123,11 +123,17 @@ tasks:
           echo "Examples successfully cloned."
     silent: false
 
-  arduino-app-cli:build:local:
+  build:
     desc: "Build the arduino-app-cli locally"
     cmds:
       - go build -v -o ./build/arduino-app-cli ./cmd/arduino-app-cli
 
+  start:
+    desc: "build and launch the arduino-app-cli in daemon mode"
+    cmds:
+      - task build
+      - ./build/arduino-app-cli daemon  --port 8800
+
   arduino-app-cli:release:
     desc: Create a tag on the current commit and push it to the remote to create the release
     cmds:
@@ -139,11 +145,7 @@ tasks:
       - git tag -a "{{.CLI_ARGS}}" -m "Release {{.CLI_ARGS}}"
       - git push origin "{{.CLI_ARGS}}"
 
-  arduino-app-cli:start:
-    desc: "build and launch the arduino-app-cli in daemon mode"
-    cmds:
-      - task arduino-app-cli:build:local
-      - ./build/arduino-app-cli daemon  --port 6060
+
 
   # To to forward a port, using ssh, you can use this command:
   # ssh -L 8800:localhost:8800 arduino@<BOARD_IP>

docs/contributor-guide/development.md

@@ -2,6 +2,11 @@
 
 # Development Guide
 
+> [!NOTE]
+> The `arduino-app-cli` is designed to run on the Board and access peripherals that are not available on a development PC (e.g., the microcontroller).
+>
+> For easier testing, using an **Arduino UNO Q** is recommended, as local testing is limited to functionalities that do not require board-specific features.
+
 ## Prerequisites
 
 The following development tools must be available in your local environment:
@@ -13,6 +18,9 @@ The following development tools must be available in your local environment:
 ## Building the Project
 
 - `task init`
+- `task build`
+- `task generate:assets` to download locally the assets of the [Arduino Bricks](`https://github.com/arduino/app-bricks-py`)
+- `ARDUINO_APP_CLI__DATA_DIR=debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli task start` to build and start the arduino-app-cli in daemon mode.
 
 ## Running Checks
 
@@ -21,11 +29,10 @@ Checks and tests are set up to ensure the project content is functional and comp
 - `task fmt-check`
 - `task test`
 
-## Testing arduino-app-cli into the board
-Connect an [Arduino UNO Q](https://docs.arduino.cc/hardware/uno-q/) board via USB.
-
- - `task board:install` installs the current version of Arduino App CLI on the board (`adb` is needed). The password of the `arduino` username of the board is requested.
-
+## Installing arduino-app-cli into the board
+This is reccomended way to test a local development version of the arduino-app-cli into a board.
+ 1. Connect an [Arduino UNO Q](https://docs.arduino.cc/hardware/uno-q/) board via USB.
+ 1. `task board:install` installs the current version of Arduino App CLI on the board (`adb` is needed). The password of the `arduino` username of the board is requested.
 
 ## Automatic Corrections
 
@@ -36,4 +43,6 @@ Tools are provided to automatically bring the project into compliance with some
 
 
 ## Generate API docs
-If th
+If a PR, change the HTTP API definitions, the following steps are needed:
+1. Open the `cmd/gendoc/docs.go` and modify/add/remove the definitions
+1. Run `task doc` to generate the docs (i.e., the files `internal/api/docs/openapi.yaml` and `internal/e2e/client/client.gen.go` are generated)

docs/contributor-guide/issues.md

@@ -14,8 +14,8 @@ https://github.com/arduino/arduino-app-cli/issues/new/choose
 
 ## Before Reporting an Issue
 
-- Give the latest development version a test drive to see if your issue was already resolved:<br />
-  <!-- TODO: Nightly build link -->
+- Give the latest development version t (pre-releases) a test drive to see if your issue was already resolved:<br />
+  https://github.com/arduino/arduino-app-cli/releases?q=prerelease%3Atrue
 - Search [existing pull requests and issues](https://github.com/arduino/arduino-app-cli/issues?q=) to see if it was already reported.<br />
   If you have additional information to provide about an existing issue, please comment there instead of creating a duplicate. You can use [GitHub's "Reactions" feature](https://github.blog/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/) if you only want to express support 👍.