[GitHub] [iceberg] samredai commented on issue #3616: Proposal: Switch docs site from mkdocs to hugo and relocate to a separate iceberg-docs repo

[GitBox <gi...@apache.org>]

samredai commented on issue #3616:
URL: https://github.com/apache/iceberg/issues/3616#issuecomment-981837253


   @ajantha-bhat I covered this a bit in my reply to Jack on the dev mailing list. We definitely could keep the docs as part of the main repo but there's extra effort on that end as well. The main one being that we'd need to align the branching pattern of the source code with the doc site versioning (`0.12.0` and `0.12.1` branches instead of `0.12.x`, for example). If we go with a separate repo, we would still maintain a copy of the docs in the main repo, and a release of a new iceberg version would include a process of pushing the docs directory to the `iceberg-docs` repo in a branch that matches the version number (we could automate that). The only time commits directly to the iceberg-docs would be required is to fix parts of the previously released versions.
   
   There are definitely pros and cons to either direction so a healthy discussion around this would be great. (Although I know this has already been explored in previous convos)


-- 
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: issues-unsubscribe@iceberg.apache.org

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



---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org