Kanbanize: Inhaltliche Anforderungen - Troubleshooting-tauglicher Detailgrad
This commit is contained in:
11
CLAUDE.md
11
CLAUDE.md
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user