chore(docs): Update tutorial

[alithethird]

Overview

Standarise the Discourse tutorial with other tutorials and improve/fix the tutorial.

Rationale

Juju Events Changes

Module Changes

Library Changes

Checklist

• The charm style guide was applied
• The contributing guide was applied
• The changes are compliant with ISD054 - Manging Charm Complexity
• The documentation is generated using src-docs
• The documentation for charmhub is updated.
• The PR is tagged with appropriate label (urgent, trivial, complex)

[github-actions]

Test coverage for 13b5ec1

Name              Stmts   Miss Branch BrPart  Cover   Missing
-------------------------------------------------------------
src/charm.py        373     41     94     15    88%   184, 192-193, 205, 337->345, 378->383, 395, 583-585, 590-591, 603-605, 610-611, 623-625, 648-650, 692->exit, 702->exit, 751-754, 764-765, 789-790, 802-803, 830-832, 834->839, 836-837, 879-880, 896-897, 907->exit, 921
src/database.py      29      1      8      1    95%   56
-------------------------------------------------------------
TOTAL               402     42    102     16    88%

Static code analysis report

Run started:2024-10-03 13:54:05.820766

Test results:
  No issues identified.

Code scanned:
  Total lines of code: 2458
  Total lines skipped (#nosec): 2
  Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
  Total issues (by severity):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
  Total issues (by confidence):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
Files skipped (0):

[nrobinaubertin]

I think that adding a way to check for RBAC wouldn't hurt here (microk8s status)

[javierdelapuente]

I would change this to: echo "10.131.49.76 discourse-k8s" | sudo tee -a /etc/hosts

[javierdelapuente]

This will fail in many cases (for example if not using the qemu backend and instead using the lxd backend in multipass). I would use instead:
ip -4 -j route get 2.2.2.2 | jq -r '.[] | .prefsrc'

[erinecon]

I would suggest changing this line to "A working station, e.g., a laptop, with amd64 architecture."