josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

Aberta

#2 aberto em 30 de out. de 2025

Ver no GitHub
 (0 comentário) (0 reação) (0 responsável)TypeScript (2 forks)auto 404
clienhancementgood first issuehelp wanted

Métricas do repositório

Stars
 (7 estrelas)
Métricas de merge de PR
 (Métricas PR pendentes)

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!

Guia do colaborador

Direção de pesquisa
Examine src/cli.ts e src/converters/pdf to markdown.ts para identificar onde as mensagens de erro são geradas. Adicione verificações específicas: existência do arquivo, status de execução do Ollama, validação do tipo de arquivo. Use chalk para saída colorida.
Pilha de tecnologia
typescript
Domain
cli
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GitTypeScript
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
85