WebAssembly / WebAssembly/WASI
Document that hard-linking may fail
Open
Nobody has claimed this yet.
P-filesystem
- Dominant language
- Rust
- Stars
- 5.8k
- Forks
- 333
- Avg merge
- 2d 13h
- Merged PRs (30d)
- 3
Description
Hard links typically cannot cross filesystems, and mount points could appear practically anywhere. Consequently, we should document that creating a hard link anywhere other than the same directory as the source may fail.
Hard linking may still be useful in portable code, as an opportunistic optimization with a copy as a fallback if the link fails. But we should document that.
Contributor guide
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
No documentation file or test is named in the issue. Start by locating the WASI documentation for hard-link creation; done when it explains same-directory limitations, possible mount-point failures, and copy-as-fallback guidance.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation, operating-systems
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100