josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

Ouverte

#2 ouverte le 30 oct. 2025

Voir sur GitHub
 (0 commentaire) (0 réaction) (0 personne assignée)TypeScript (2 forks)auto 404
clienhancementgood first issuehelp wanted

Métriques du dépôt

Stars
 (7 étoiles)
Métriques de merge PR
 (Métriques PR en attente)

Description

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!

Guide contributeur

Direction de recherche
Examinez src/cli.ts et src/converters/pdf to markdown.ts pour identifier où les messages d'erreur sont générés. Ajoutez des vérifications spécifiques : existence du fichier, état d'exécution d'Ollama, validation du type de fichier. Utilisez chalk pour la sortie colorée.
Stack technique
typescript
Domaine
cli
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
GitTypeScript
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
85