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] sphinx design 1/n #34625

Merged
merged 7 commits into from
Apr 21, 2023
Merged

[docs] sphinx design 1/n #34625

merged 7 commits into from
Apr 21, 2023

Conversation

maxpumperla
Copy link
Contributor

First PR of many to replace the old and unmaintained spinx-panels by the newer plugin with LTS (by the same authors) called sphinx-design. Slightly different syntax, but same functionality. Stylistically slightly different, but more powerful later on. We need to take care of 3 things (the latter 2 always go together):

  • replace tabbed by either tabs or tab-set
  • replace link-button by button-ref and button-link
  • replace panels by grid

Important: once fully removing sphinx-panels from dependencies, we can finally upgrade our theme and the base sphinx version to.

Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Copy link
Collaborator

@jjyao jjyao left a comment

Choose a reason for hiding this comment

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

Excited!!

Signed-off-by: Max Pumperla <[email protected]>
@@ -308,7 +308,7 @@ build_sphinx_docs() {
if [ "${OSTYPE}" = msys ]; then
echo "WARNING: Documentation not built on Windows due to currently-unresolved issues"
else
FAST=True make html
FAST=True make develop
Copy link
Contributor Author

@maxpumperla maxpumperla Apr 21, 2023

Choose a reason for hiding this comment

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

this is slightly risky, will revert this after N/N for this migration. the two plugins in question currently clash and throw a warning. Note that this only suppresses warnings, not errors.

Signed-off-by: Max Pumperla <[email protected]>
@maxpumperla
Copy link
Contributor Author

doctest and linkcheck failures are unrelated

@richardliaw richardliaw merged commit 76ee4dd into master Apr 21, 2023
@richardliaw richardliaw deleted the mp_sphinx_design branch April 21, 2023 21:44
elliottower pushed a commit to elliottower/ray that referenced this pull request Apr 22, 2023
ProjectsByJackHe pushed a commit to ProjectsByJackHe/ray that referenced this pull request May 4, 2023
architkulkarni pushed a commit to architkulkarni/ray that referenced this pull request May 16, 2023
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