PhilflowIO/tsdav

Improve error messages and troubleshooting

Open

#17 aperta il 28 ott 2025

Vedi su GitHub
 (1 commento) (0 reazioni) (0 assegnatari)TypeScript (0 fork)auto 404
documentationenhancementgood first issuephase-2

Metriche repository

Star
 (0 star)
Metriche merge PR
 (Metriche PR in attesa)

Descrizione

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

Guida contributor

Direzione di ricerca
Studia la gestione degli errori esistente nel codice, identifica i punti chiave degli errori (es. autenticazione, richieste API) e implementa il pattern suggerito nell'issue: codici di errore dettagliati con link alla documentazione, suggerimenti per la risoluzione, esportazione del log degli errori in JSON e integrazione con il flag ` debug`.
Tech stack
typescript
Dominio
developer experiencecli
Tipo issue
Funzionalità
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-2 giorni
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
GitTypeScript
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
75