-
Notifications
You must be signed in to change notification settings - Fork 783
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: use lychee
to check link URLs
#3941
Conversation
Ok, this should be good to review. Fixed so many broken links 😅 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks!
Contributing.md
Outdated
@@ -70,6 +70,12 @@ First, install [`mdbook`][mdbook] and [`nox`][nox]. Then, run | |||
nox -s build-guide -- --open | |||
``` | |||
|
|||
To check all links in the guide are valid, also install [`lychee`][lychee] use the `check-guide` session instead: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this sentence does not sound quite right
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good point, I've added "and" - "and use the..."
@@ -43,7 +43,7 @@ The table below contains the Python type and the corresponding function argument | |||
| `typing.Sequence[T]` | `Vec<T>` | `&PySequence` | | |||
| `typing.Mapping[K, V]` | `HashMap<K, V>`, `BTreeMap<K, V>`, `hashbrown::HashMap<K, V>`[^3], `indexmap::IndexMap<K, V>`[^4] | `&PyMapping` | | |||
| `typing.Iterator[Any]` | - | `&PyIterator` | | |||
| `typing.Union[...]` | See [`#[derive(FromPyObject)]`](traits.html#deriving-a-hrefhttpsdocsrspyo3latestpyo3conversiontraitfrompyobjecthtmlfrompyobjecta-for-enums) | - | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
😱
Replaces #3939
lychee
is better maintained and more comprehensive thanmdbook-linkcheck
.I was able to get it to run to check the
guide
links and also the (external) rustdoc links.