josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

Offen

#2 geöffnet am 30.10.2025

Auf GitHub ansehen
 (0 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)TypeScript (2 Forks)auto 404
clienhancementgood first issuehelp wanted

Repository-Metriken

Stars
 (7 Sterne)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

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!

Contributor Guide

Research-Richtung
Untersuchen Sie src/cli.ts und src/converters/pdf to markdown.ts, um zu identifizieren, wo Fehlermeldungen generiert werden. Fügen Sie spezifische Prüfungen hinzu: Dateiexistenz, Ollama Ausführungsstatus, Dateitypüberprüfung. Verwenden Sie chalk für farbige Ausgabe.
Tech Stack
typescript
Domain
cli
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-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Frisch
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.
85