Skip to content

Conversation

@foskey51
Copy link
Contributor

Which issue does this PR close?

What changes are included in this PR?

I've enabled the navbar, which is required to use dark-light mode toggle and made following changes in the ui

  • Removed the existing logo in the side-bar (as it was redundant)
  • Removed search bar in the side-bar (as it was conflicting with navbar's search widget)

image

image

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Oct 28, 2025
@Jefffrey
Copy link
Contributor

Some things I noticed:

  • Toggle has 3 states (and 3 different icons)
  • Theme is remembered per page, not globally; e.g. if I set light mode (default is dark) on home/index page, and I navigate to another page, that page will be dark but when I navigate back to home it'll be light
  • The More menu on the navbar doesn't play well given it's length, might be better off removing it
  • I also prefer removing the other links on the navbar (e.g. License, Donate) given they are also at the top of the sidebar; either keep the sidebar ones or keep only the navbar ones to remove this duplication

@foskey51
Copy link
Contributor Author

hey @Jefffrey

  • Your are seeing 3 states (light, dark, system-theme) because it's default and there's no implicit way to remove the system-theme aka third state you can refer this issue, explicitly removing it might cause unexpected behavior.

  • The "theme is remembered per page" is caused due to accessing the index.html directly as file:///xyz/datafusion/docs/build/html/index.html so now dev-tools>storage>local-storage variables responsible for theming are tracked by dynamically changing file name which ends-up getting a new default state for each file. To resolve this, try serving it via a http server like

#run it in docs/ dir
python3 -m http.server 8000

#access the docs build at
http://localhost:8000/build/html/index.html

now local storage tracks it by host-name aka http://localhost:8000. So this shouldn't be an issue in production, as it will be tracked by domain name.

  • I've removed the links displayed in the navbar.


Screenshot 2025-10-29 at 21-12-33 Apache DataFusion — Apache DataFusion documentation(2)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Website: dark mode toggle

2 participants