Re: [I] Versioned documentation [datafusion]

Thu, 27 Aug 2026 12:33:47 -0700 


yiaany commented on issue #17071:
URL: https://github.com/apache/datafusion/issues/17071#issuecomment-5444251858

   > > Based on the maintainer feedback, I propose starting with a minimal 
first milestone:
   > 
   > I think this sounds like a great plan. I will help make this happen / test 
it
   > 
   > I think we should only version the user guide and library guide. I don't 
think there is any reason to version the contributor guide or other areas of 
the site
   > 
   > <img alt="Image" width="619" height="1192" 
src="https://private-user-images.githubusercontent.com/490673/641741383-5f63c30b-ca67-412f-b9f0-c32b74ca4c36.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODc4NTk0NTAsIm5iZiI6MTc4Nzg1OTE1MCwicGF0aCI6Ii80OTA2NzMvNjQxNzQxMzgzLTVmNjNjMzBiLWNhNjctNDEyZi1iOWYwLWMzMmI3NGNhNGMzNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwODI3JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDgyN1QxOTMyMzBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1kNDUyNWFhNTc5MTgxNzI3OTQ1MTRlY2E0YjQwZjYwMWJiYTY5YWYyMGU1YTM2YzM1ZDVmMTBiNGEzYzI2MWNkJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.JhB1tpysAaHkhsNAntHcSwlP2D8dSBwCsIF14HSIVyI";>
   > Note I will be out next week traveling / vacation so I may not have a 
chance to really look at it until the week after (or other reviewers / 
committers can do so to)
   > 
   > > A few details I would like to confirm:
   > 
   > > Should https://datafusion.apache.org/ continue to show main, or should 
it eventually resolve to the latest released documentation?
   > 
   > Yes I think it should continue to show the latest version of main
   > 
   > > Is 55.0.0 the preferred first version for the proof of concept?
   > > Yes
   > 
   > > Should the first PR publish a manually generated 55.0.0 snapshot, with 
release automation handled separately?
   > 
   > Yes. I can run / publish the relevant snapshot for testing
   > 
   > > Is there a preferred URL convention, such as /55.0.0/, /version/55.0.0/ 
or another structure?
   > 
   > Whatever comet does, which I think are like this
   > 
   > https://datafusion.apache.org/comet/user-guide/1.0/installation.html
   
   One question before implementation: the exact 55.0.0 tag contains a note in 
docs/source/library-user-guide/upgrading/55.0.0.md saying that DataFusion 
55.0.0 has not been released yet.
   
   Should the published 55.0.0 documentation preserve the exact tagged content, 
or may the snapshot build apply a small, explicitly documented correction 
removing this outdated note?
   
   My preference is to preserve the exact tag unless maintainers approve this 
snapshot-only correction.
   


-- 
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]

Reply via email to