Kanbanize: Inhaltliche Anforderungen - Troubleshooting-tauglicher Detailgrad

This commit is contained in:
root
2026-01-31 14:26:44 +01:00
parent d3d79f4712
commit 129073eb23

View File

@@ -970,6 +970,17 @@ Die API gibt immer `type: plain` zurück, rendert aber trotzdem HTML.
| Aufzählung | `• Text` (Unicode U+2022) | • Text | | Aufzählung | `• Text` (Unicode U+2022) | • Text |
| Unter-Aufzählung | `◦ Text` (Unicode U+25E6) | ◦ Text | | Unter-Aufzählung | `◦ Text` (Unicode U+25E6) | ◦ Text |
### Inhaltliche Anforderungen
**Kommentare müssen genug Detail enthalten, um bei Problemen als Troubleshooting-Einstieg zu dienen.**
- Bei jeder Erwähnung eines Dienstes/Protokolls die konkreten Verbindungsdaten angeben (Host, Port, Protokoll)
- Nicht: "per SMTP verschickt" → Sondern: "per SMTP über smtp.mailbox.org:465 (SSL/TLS) verschickt"
- Nicht: "IMAP-Abruf" → Sondern: "IMAP IDLE auf imap.mailbox.org:993 (TLS)"
- Nicht: "auf dem Server" → Sondern: "auf srv-docker02 (/home/vinosadmin/n8n/)"
- Pfade, IPs, Ports, Credentials-Quellen immer mit angeben
- **Ziel:** Jemand der den Kommentar liest, weiß sofort wo er nachschauen muss wenn etwas nicht funktioniert
### Pitfalls ### Pitfalls
- **Kommentare können NICHT gelöscht werden** — weder via API noch UI. Workaround: Inhalt durch `.` ersetzen - **Kommentare können NICHT gelöscht werden** — weder via API noch UI. Workaround: Inhalt durch `.` ersetzen