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

Update linkcheck_rate_limit_timeout docs using seconds instead of minutes #12225

Merged
merged 3 commits into from
Apr 5, 2024

Conversation

noklam
Copy link
Contributor

@noklam noklam commented Apr 2, 2024

Subject:

Feature or Bugfix

https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-linkcheck_rate_limit_timeout
The docs here states that the default is 5 minutes. I checked the class itself doesn't have docstring about the unit. I am not sure exactly why or it's a convention.

I have run into a CI issues that timeout, after changing the configuration a few times and look into the source code. I found out the unit of the configuration is seconds instead of minutes.

kedro-org/kedro#3769

Purpose

To make this clear the units of the configuration is seconds instead of minute.

I can also update change in code when appropriate but please let me know where should the change goes in.

@noklam noklam changed the title Update configuration.rst using the correct units Update configuration.rst using seconds instead of minutes Apr 2, 2024
@noklam noklam changed the title Update configuration.rst using seconds instead of minutes Update linkcheck_rate_limit_timeout docs using seconds instead of minutes Apr 2, 2024
doc/usage/configuration.rst Outdated Show resolved Hide resolved
@picnixz
Copy link
Member

picnixz commented Apr 4, 2024

Err... that's a good catch. But we should maybe make it clear that the unit is in seconds.

noklam and others added 2 commits April 5, 2024 10:42
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
@noklam noklam requested a review from picnixz April 5, 2024 09:48
@picnixz picnixz merged commit 17a84a6 into sphinx-doc:master Apr 5, 2024
7 checks passed
@picnixz
Copy link
Member

picnixz commented Apr 5, 2024

Thank you!

@github-actions github-actions bot locked as resolved and limited conversation to collaborators May 6, 2024
@AA-Turner AA-Turner added this to the 7.3.0 milestone Jul 13, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants