Docs missing version dropdown

[kevinjqliu]

I'm really happy to see the "version dropdown" in the Iceberg website. I think it's a great feature to have.

Problem

Looks like the version dropdown in the header disappears when I read the actual doc webpage.
For example:
https://iceberg.apache.org/docs/latest/
https://iceberg.apache.org/docs/0.13.1/
https://iceberg.apache.org/docs/0.12.1/

Which is weird because I followed the iceberg-docs instructions and ran it locally. Locally there is the version dropdown in the header:

Reading the docs deployment documentation, my hunch is that the version dropdown was added recently and the older versions of the docs were not updated to reflect this change.

cc @samredai since you've enabled the version-dropdown

[samredai]

@kevinjqliu thanks for your comments and opening this issue! Yes the new theme will provide the experience you're seeing locally where the top nav bar is fixed and the version drop-down is always available.

We're in the process of deploying the theme to the versioned docs site (each version of the docs site is deployed on its own) so once that's deployed, this will all be live. This should be done within a few days. 👍

[kevinjqliu]

awesome! so this is not a bug. I'll close out the issue.

Im curious how you were able to make this work across versions. I really like this feature and want to do the same for other projects docs. like for trino trinodb/trino#13205
@samredai

[samredai]

@kevinjqliu the magic happens in 3 places really. The versions are defined in the config.toml file, that list is used to generate the drop-down in the theme, and then the deployment CI deploys the site to a sub-directory named after the branch/version name.

We use hugo but I would imagine a similar setup is achievable with most other static site frameworks. Let me know if you want to chat about how to make this work with your deployment setup. 😃