backstage / backstage/mkdocs-monorepo-plugin

Fails to build on Windows when docs drive is different from TEMP

Open
#136 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
400
Forks
80
PR merge metrics
No merged PRs in 30d

Description

When building documentation under Windows, fails with the message like:
> Error reading page 'index.md': path is on mount 'C:', start on mount 'T:'

The reason, as I understand, is monorepo plugin creating some temporary files there, and path.relpath() throwing that as an exception.

Contributor guide

Open the contributing guide

Research direction

Reproduce the documentation build on Windows with the documentation drive different from TEMP, then trace the monorepo plugin's temporary-file handling to the path.relpath() call mentioned in the report. Done means the build completes successfully across different drive letters without the mount-related exception.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.