feat: docs

.gitignore

@@ -50,3 +50,5 @@ yarn-debug.log*
 .yarn-integrity
 
 /.task
+/.yardoc
+/public/doc/

Gemfile

@@ -116,6 +116,7 @@ group :development, :test do
 end
 
 group :development do
+  gem 'yard'
   gem 'brakeman'
   gem 'haml-lint', require: false
   gem 'letter_opener'

Gemfile.lock

@@ -574,6 +574,7 @@ GEM
     websocket-extensions (0.1.5)
     xpath (3.2.0)
       nokogiri (~> 1.8)
+    yard (0.9.34)
     zeitwerk (2.6.8)
 
 PLATFORMS
@@ -669,6 +670,7 @@ DEPENDENCIES
   web-console
   webpacker
   yaml_db!
+  yard
 
 RUBY VERSION
    ruby 3.1.4p223

README.md

@@ -28,6 +28,16 @@ instalación (en inglés)](https://taskfile.dev/installation/)
 go-task
 ```
 
+### Documentación
+
+Para navegar la documentación del código usando YARD:
+
+```bash
+go-task doc serve
+```
+
+Y luego navegar a <https://panel.sutty.local:3000/doc/>
+
 ## English
 
 Sutty is a platform for hosting safer, faster and more resilient
@@ -51,3 +61,14 @@ instructions](https://taskfile.dev/installation/).
 ```bash
 go-task
 ```
+
+### Documentation
+
+To browse documentation using YARD:
+
+```bash
+go-task doc serve
+```
+
+And then open <https://panel.sutty.local:3000/doc/>
+

Taskfile.yaml

@@ -114,3 +114,9 @@ tasks:
     status:
     - "test -f tmp/pids/server.pid"
     - "pgrep -F tmp/pids/server.pid"
+  doc:
+    desc: "Build documentation"
+    deps:
+    - "gems"
+    cmds:
+    - "{{.HAINISH}} bundle exec yardoc -o public/doc app lib config db"