Skip to content

docs: expand Troubleshooting guide with common startup and runtime issues - #14

Open
TrueFurina wants to merge 1 commit into
Aryan27-max:mainfrom
TrueFurina:docs/troubleshooting-guide
Open

TrueFurina wants to merge 1 commit into
Aryan27-max:mainfrom
TrueFurina:docs/troubleshooting-guide

Conversation

@TrueFurina

Copy link
Copy Markdown

Summary

Per #7: the README's Troubleshooting table covered only the most basic cases (Ollama, OCR, Excel lock, network). Expanded it with the common startup/runtime issues from the issue's suggested topics.

Changes

  • README.md: extended the Troubleshooting table with six new rows:
    • PyTorch not installed / import error
    • EasyOCR fails to initialize
    • PDF parsing fails (pymupdf / password-protected files)
    • Watch mode does not detect new resumes (Watchdog, network drives)
    • Windows permission / file lock errors (Excel/Word locks, Program Files paths)
    • Port 11434 already in use (netstat check)

Kept the existing rows untouched; table style unchanged.

Acceptance criteria

  • Dedicated Troubleshooting section exists and covers common startup/runtime issues
  • Solutions accurate, beginner-friendly, consistent with the existing rows
  • Internal links (Installation section) referenced where relevant

@TrueFurina

Copy link
Copy Markdown
Author

Friendly ping - this is still open on my side and mergeable as far as I can tell. Happy to address any remaining feedback if something is blocking it. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant