Skip to content
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

Merged
merged 6 commits into from
Mar 8, 2024
Merged

Conversation

davidhewitt
Copy link
Member

Replaces #3939

lychee is better maintained and more comprehensive than mdbook-linkcheck.

I was able to get it to run to check the guide links and also the (external) rustdoc links.

@davidhewitt
Copy link
Member Author

Ok, this should be good to review. Fixed so many broken links 😅

Copy link
Member

@mejrs mejrs left a 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:
Copy link
Member

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

Copy link
Member Author

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..."

@davidhewitt davidhewitt enabled auto-merge March 8, 2024 13:33
@@ -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) | - |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

😱

@davidhewitt davidhewitt added this pull request to the merge queue Mar 8, 2024
Merged via the queue into PyO3:main with commit 14d1d2a Mar 8, 2024
42 checks passed
@davidhewitt davidhewitt deleted the lychee branch March 8, 2024 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants