josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

Aperta

#2 aperta il 30 ott 2025

Vedi su GitHub
 (0 commenti) (0 reazioni) (0 assegnatari)TypeScript (2 fork)auto 404
clienhancementgood first issuehelp wanted

Metriche repository

Star
 (7 stelle)
Metriche merge PR
 (Metriche PR in attesa)

Descrizione

Make error messages more user-friendly when users make common mistakes.

Tasks:

  • Add specific error when file doesn't exist
  • Add hint when Ollama is not running (for PDF→MD)
  • Add suggestion when wrong file type is provided
  • Improve error formatting with colors (using chalk)

Files to modify:

  • src/cli.ts
  • src/converters/pdf-to-markdown.ts

Good First Issue: Simple TypeScript changes with clear requirements!

Guida contributor

Direzione di ricerca
Esamina src/cli.ts e src/converters/pdf to markdown.ts per identificare dove vengono generati i messaggi di errore. Aggiungi controlli specifici: esistenza del file, stato di esecuzione di Ollama, validazione del tipo di file. Usa chalk per output colorati.
Tech stack
typescript
Dominio
cli
Tipo issue
Funzionalità
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Nuova
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
GitTypeScript
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
85