rambleraptor commented on issue #2242: URL: https://github.com/apache/iceberg-python/issues/2242#issuecomment-3165676167
It seems like we should consider hosting docs for past versions, including the nightly build. There's a couple different ways we could handle this: 1. [mike](https://github.com/jimporter/mike) seems to be the default way of handling versions with Material MKDocs. * Pros: We get a nice version selector at the top of the page to choose what version you'd like to see. * Cons: It's very opinionated and includes a CLI that handles Git commits to gh-pages for us. Unclear what the URL structure would look like. 2. A script that copies the docs from past branches, creates a synthetic docs folder, and then publishes that * Pros: It's very similar to how Iceberg Java handles this. * Cons: We'd have to change up our navbar and URLs to fit the version. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
