update command line documentations

Author: neverRare

README.md

@@ -9,54 +9,11 @@ interpretation of the text. No machine learning involved.
 **It is work in progress!**
 [We welcome contributors however!](./CONTRIBUTING.md)
 
-## Dependencies
+## Building locally
 
-You'll need the following in order to run commands:
+You'll need [Deno](https://deno.com/) for this project. Then you'll need to
+install the dependencies before running any command: `deno install`.
 
-- [Deno](https://deno.com/)
-
-Before running any command line mentioned here, run the following command first.
-
-```
-deno install
-```
-
-## Building
-
-This builds the distribution code at `./dist/main.js` as minified file ready for
-production use, it also builds the source map so contributors can directly debug
-the production code.
-
-```
-deno task build
-```
-
-Before building the distribution code, it builds the dictionary first by
-transforming the dictionary into a code at `./dictionary/dictionary.ts`. This
-enables faster code startup without dealing with file access or network access.
-
-## Watching
-
-This is similar to [building](#building) but it doesn't minify the code. This
-command also watches the codes in `./src/` and `./dictionary/` including the
-dictionary and rebuilds whenever there are changes. To stop this command, simply
-press Ctrl + C.
-
-```
-deno task watch
-```
-
-## Running locally with browser
-
-After building or watching, you can directly run `./dist/index.html` with your
-browser to test ilo Token. If you wish to start a local server, run
-`deno task start`. The stdout will tell you the URL to use.
-
-## Running locally with Deno
-
-This will run a REPL that you can use to test ilo Token. To stop this command,
-simply press Ctrl + D or Ctrl + C.
-
-```
-deno task repl
-```
+After this, you can start away by running `deno task watch` then open
+`./dist/index.html` using your favorite browser. Run `deno task` to see more
+useful command lines.

deno.json

@@ -3,15 +3,31 @@
     "lib": ["dom", "deno.ns"]
   },
   "tasks": {
-    "build": "deno run -E -R -W -N=jsr.io --allow-run --no-prompt --frozen --cached-only ./bundle.ts build",
+    "build": {
+      "description": "Builds `./dist/main.js` as minified file with source mapping at `./dist/main.js.map`. This command also builds the dictionary at `./dictionary/dictionary.ts`.",
+      "command": "deno run -E -R -W -N=jsr.io --allow-run --no-prompt --frozen --cached-only ./bundle.ts build"
+    },
+    "watch": {
+      "description": "Similar to `deno task build` but doesn't minify the code. This command also watches the source code and rebuilds `./dist/main.js` or `./dictionary/dictionary.ts` whenever necessary. This DOESN'T auto-refreshes the webpage.",
+      "command": "deno run -E -R -W -N=jsr.io --allow-run --no-prompt --frozen --cached-only ./bundle.ts watch"
+    },
+    "start-server": {
+      "description": "Starts a local server serving `./dist/` statically",
+      "command": "deno run -N=0.0.0.0 -R=./dist/ --no-prompt jsr:@std/http/file-server ./dist/"
+    },
     "repl": {
+      "description": "Starts a REPL",
       "command": "deno run --no-prompt --frozen --cached-only ./src/repl.ts",
       "dependencies": ["build-dictionary"]
     },
-    "start": "deno run -N=0.0.0.0 -R=./dist/ --no-prompt jsr:@std/http/file-server ./dist/",
-    "watch": "deno run -E -R -W -N=jsr.io --allow-run --no-prompt --frozen --cached-only ./bundle.ts watch",
-    "update": "deno outdated --update && deno run -N=api.linku.la,gitlab.com -W=./telo_misikeke/linku_data.json,./telo_misikeke/Parser.js,./telo_misikeke/rules.js --no-prompt --frozen --cached-only ./telo_misikeke/update.ts",
-    "build-dictionary": "deno run -R=./dictionary/dictionary -W=./dictionary/dictionary.ts --no-prompt --frozen --cached-only ./dictionary/build.ts"
+    "update": {
+      "description": "Updates dependencies and telo misikeke",
+      "command": "deno outdated --update && deno run -N=api.linku.la,gitlab.com -W=./telo_misikeke/linku_data.json,./telo_misikeke/Parser.js,./telo_misikeke/rules.js --no-prompt --frozen --cached-only ./telo_misikeke/update.ts"
+    },
+    "build-dictionary": {
+      "description": "Builds the dictionary at `./dictionary/dictionary.ts`",
+      "command": "deno run -R=./dictionary/dictionary -W=./dictionary/dictionary.ts --no-prompt --frozen --cached-only ./dictionary/build.ts"
+    }
   },
   "fmt": {
     "exclude": [