Local docs server keeps hanging
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 23
- Forks
- 20
- Avg merge
- 3d 1h
- Merged PRs (30d)
- 6
Description
I'm not sure if it's me, but whenever I try and start the docs server it just hangs at random points.
Right now it's hanging at
[INFO] Starting the development server...
But earlier today is was hanging while updating the build.
Once it dies, the process seems irretrievable. I can't kill it. When I shut down my system (Linux Mint), the shutdown log tells me it's waiting for a node process to quit. Never seen that befoe.
It's only started doing this today.
I have a horrible feeling it's the FHIR4 docs (which are massive)
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the hang when the docs development server reaches “Starting the development server...” or while updating the build, with attention to the large FHIR4 docs. Inspect the node process after the server becomes unresponsive and compare it with the shutdown behavior. Done means identifying the cause and documenting or verifying a reliable fix for the hanging process.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, node.js
- Domain
- build-system, documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100