PhilflowIO/tsdav

Improve error messages and troubleshooting

Open

#17 geöffnet am 28. Okt. 2025

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (0 zugewiesene Personen)TypeScript (0 Forks)auto 404
documentationenhancementgood first issuephase-2

Repository-Metriken

Stars
 (0 Stars)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

Make error messages more helpful and actionable.

Requirements:

  • Detailed error codes with links to documentation
  • Suggest fixes for common errors
  • Export detailed error log (JSON format)
  • Integration with --debug flag

Example:

Error: Authentication failed (HTTP 401)
Possible causes:
  1. Invalid credentials
  2. OAuth token expired
  3. Insufficient permissions

Troubleshooting steps:
  - Verify credentials in .env file
  - Regenerate OAuth refresh token
  - Check API permissions in Google Cloud Console

For more help: https://docs.example.com/errors/AUTH_401

Estimated Effort: Small (2 days)

Related to: DAV Migration CLI - Phase 2

Contributor Guide

Research-Richtung
Studieren Sie die vorhandene Fehlerbehandlung im Code, identifizieren Sie wichtige Fehlerpunkte (z. B. Authentifizierung, API Anfragen) und implementieren Sie das in der Ausgabe vorgeschlagene Muster: detaillierte Fehlercodes mit Dokumentationslinks, Korrekturvorschläge, JSON Fehlerlog Export und Integration mit dem ` debug` Flag.
Tech Stack
typescript
Domain
developer experiencecli
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-2 Tage
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
GitTypeScript
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
75