You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@datafusion.apache.org by "andygrove (via GitHub)" <gi...@apache.org> on 2025/10/15 18:01:11 UTC

[I] Stop storing generated docs in git [datafusion-comet]

andygrove opened a new issue, #2582:
URL: https://github.com/apache/datafusion-comet/issues/2582

   ### What is the problem the feature request solves?
   
   Rather than updating parts of `configs.md` in-place as part of the build, it would be better not to store the generated content in git and instead only generate the dynamic parts as part of the publishing process. We publish the documentation on all merges to main.
   
   ### Describe the potential solution
   
   _No response_
   
   ### Additional context
   
   _No response_


-- 
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: github-unsubscribe@datafusion.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For additional commands, e-mail: github-help@datafusion.apache.org


Re: [I] Stop storing generated docs in git [datafusion-comet]

Posted by "andygrove (via GitHub)" <gi...@apache.org>.
andygrove commented on issue #2582:
URL: https://github.com/apache/datafusion-comet/issues/2582#issuecomment-3555264587

   Some notes on the current implementation.
   
   We currently publish the documentation site on all merges to main. We use `rsync` with a `--delete` flag to remove all content before publishing the current content. This means that all content for older releases is removed and needs to be republished. The scripts do this by cloning recent release branches and copying the markdown files from those branches into the current working tree.
   
   The scripts also dynamically update the markdown content for older releases to add warnings that this is out-of-date documentation, with links to the content for the latest official release.
   
   HTML is generated from the markdown content and pushed to the `asf-site` branch, which then gets published by GitHub Pages.
   


-- 
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: github-unsubscribe@datafusion.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For additional commands, e-mail: github-help@datafusion.apache.org


Re: [I] Stop storing generated docs in git [datafusion-comet]

Posted by "andygrove (via GitHub)" <gi...@apache.org>.
andygrove closed issue #2582: Stop storing generated docs in git
URL: https://github.com/apache/datafusion-comet/issues/2582


-- 
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: github-unsubscribe@datafusion.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscribe@datafusion.apache.org
For additional commands, e-mail: github-help@datafusion.apache.org