Support a relative path for the options to "link to source" for the --target-path CLI option
#490 aberto em 24 de fev. de 2023
Métricas do repositório
- Stars
- (1.356 estrelas)
- Métricas de merge de PR
- (Mesclagem média 24d 11h) (33 fundiu PRs em 30d)
Description
Feature Name
support relative paths for --target-path
Description
I started trying to use the feature for including links to hosted online source, as described in Distributing Documentation to Other Developers.
The --target-path option currently requires an absolute path to the location to reference the source, and it would tremendously more convenient if this were provided in the form of a relative path.
Per a thread in swift forums, Franklin made a reference to a likely location for the possible enhancement.
Motivation
Allowing a relative path makes any CI/scripted work significantly easier for generating documentation, as it more easily divorces the location from the machine. It's possible to work around this in a shell script (something like "$(dirname $(dirname $(filepath $0)))", as seen in https://github.com/apple/swift-markdown/blob/main/bin/update-gh-pages-documentation-site), but that's not common knowledge or easily found.
Importance
Entirely an ease-of-use scenario
Alternatives Considered
No response