docs: clarify path dependency portability

[nightcityblade]

Pull Request Check List

Resolves: #6752

• Added tests for changed code. N/A — documentation-only change.
• Updated documentation for changed code.

Summary

Clarify that path dependencies are intended for local development and remain
non-portable in built distributions because Poetry records them as file://
requirements. Recommend publishing the dependency and replacing the path with a
version constraint before distribution.

Validation

• pre-commit run --files docs/dependency-specification.md
• Built the documentation with the python-poetry/website build script.
• Built the static website with Hugo and verified the rendered note.
• Reproduced the behavior with Poetry by inspecting wheel and sdist metadata.

[sourcery-ai]

Hey - I've reviewed your changes and they look great!

Sourcery assessment

Approved.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.