Skip to content

Conversation

@mfeurer
Copy link
Collaborator

@mfeurer mfeurer commented Apr 7, 2021

This aims to fix broken links in the documentation. In order to do so it does:

  • make warnings during documentation building fail the build process
  • fix all warnings to make the build process pass
  • automatically check for links to work with make checklink
  • fix all links and update links for which a redirect was shown

In the process of creating this PR I opened #1046 and #1047 so we can in the future fully automate the process of checking that all links work we have references to all objects in the API and examples.

@mfeurer mfeurer requested review from PGijsbers and removed request for PGijsbers April 7, 2021 09:25
Copy link
Collaborator

@PGijsbers PGijsbers left a comment

Choose a reason for hiding this comment

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

Thanks! Automating checking for broken links is awesome :)
Few questions:

  • I built the docs locally, but did not check all the links work - is that alright?
  • What stops us from referencing numpy docs to turn nitpicky on?
  • Could you add this work to progress.rst?

@mfeurer
Copy link
Collaborator Author

mfeurer commented Apr 9, 2021

I built the docs locally, but did not check all the links work - is that alright?

Yes, you need to explicitly do make linkcheck

What stops us from referencing numpy docs to turn nitpicky on?

The fact that this already took me too long and I didn't have time any more ;) I think nitpicky also complained about the task type enum which I didn't know how to fix.

Could you add this work to progress.rst?

Sure.

@mfeurer mfeurer force-pushed the fix_documentation branch from 8677756 to 34011ef Compare April 9, 2021 08:56
@mfeurer mfeurer requested a review from PGijsbers April 9, 2021 08:56
@PGijsbers
Copy link
Collaborator

The doc jobs fail.

@mfeurer
Copy link
Collaborator Author

mfeurer commented Apr 9, 2021

The doc jobs fail.

Yes, the rebase on #1044 made it fail :( I'll be working on that soonish, but probably not this week any more...

@mfeurer mfeurer force-pushed the fix_documentation branch from 218cc46 to 7a00940 Compare April 16, 2021 07:27
Copy link
Collaborator

@PGijsbers PGijsbers left a comment

Choose a reason for hiding this comment

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

Let's use the built-in function for generating openml urls. A bit less daunting and, at least as important, more future proof.

@mfeurer
Copy link
Collaborator Author

mfeurer commented Apr 20, 2021

Great suggestion, just applied it!

@mfeurer mfeurer requested a review from PGijsbers April 20, 2021 18:15
Copy link
Collaborator

@PGijsbers PGijsbers left a comment

Choose a reason for hiding this comment

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

LGTM 🎉

@PGijsbers PGijsbers merged commit 10c9dc5 into develop Apr 21, 2021
@PGijsbers PGijsbers deleted the fix_documentation branch April 21, 2021 09:39
github-actions bot pushed a commit that referenced this pull request Apr 21, 2021
PGijsbers added a commit to Mirkazemi/openml-python that referenced this pull request Feb 23, 2023
* fix warnings, make sphinx fail on warnings

* fix a few links

* fix a bunch of links

* fix more links

* fix all remaining links

* and finally add the link checker

* debug workflow

* more debug

* undo debug

* Add to changelog

* fix new warning

* clean up more errors

* Fix link after rebase

* Apply suggestions from code review

Co-authored-by: PGijsbers <[email protected]>

Co-authored-by: PGijsbers <[email protected]>
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