It would be my preference to separate out the website docs from https://github.com/apache/hamilton/ and put them in a separate https://github.com/apache/hamilton-site/ repo. It simplifies the release of Apache Hamilton if we don't need to worry about reviewers having to check the source headers and licensing of everything needed for the website build too. The simplest initial set up is to have apache/hamilton-site git repo set up so that a Hamilton team member can checkout the apache/hamilton-site git repo and run the build on their own machine. The HTML etc for the website gets generated to a directory like `content` or `publish`. The Hamilton team member can then commit the content or publish directory into git. We can configure the .asf.yaml file so that the website is redeployed based on git commits that include changes to the `content` or `publish` dir. We can look into trying to automate this later. It will need time to interact with ASF Infra team to be allowed to have automated jobs commit to the git repo.
On Sat, 14 Jun 2025 at 07:24, Stefan Krawczyk <[email protected]> wrote: > > Okay just so I mentally I understand. > > 1. We can have documentation source live under /docs > 2. When a PR that changes docs is created/merged we can kick off a github > workflow that builds these docs > 3. Is it correct that we could then push this built HTML to this other > hamilton-site repo? Is that correct? > 4. Then using the `.asf.yaml` in the hamilton-site repo, we could use > the .asf.yaml > directives > <https://cwiki.apache.org/confluence/display/INFRA/git+-+.asf.yaml+features#Git.asf.yamlfeatures-WebsitedeploymentserviceforGitrepositories> > to then publish which would update hamilton.apache.org. > > Is that right? > > Cheers, > > Stefan > > > > > > On Mon, Jun 9, 2025 at 5:02 AM PJ Fanning <[email protected]> wrote: > > > Redirecting to dev mailing list. Private mailing list is for 2 things > > - discussing and voting on new committers and discussing security > > issues. Everything else is meant to be discussed in public. > > > > The main doc for web site publishing is: > > https://github.com/apache/infrastructure-asfyaml/blob/main/README.md > > > > We already have a DNS entry set up for hamilton.apache.org. > > > > Most ASF projects push the static content for their web site to a > > directory in a git repo. We can create an apache/hamilton-site repo > > for this. > > > > There are other approaches that might be feasible. One example is > > pekko.apache.org content - most of it is rsynced to > > nightlies.apache.org and we use .htaccess files deployed to > > pekko.apache.org to allow the nightlies.apache.org content to be > > accessed as if it was deployed directly to pekko.apache.org. This > > avoids having to git commit the generated content (only the markdown > > files from which the HTML is generated are in git). > > > > > > On Mon, 9 Jun 2025 at 04:57, Stefan Krawczyk <[email protected]> > > wrote: > > > > > > Hi Mentors, > > > > > > I assume hamilton.apache.org is the front page for the project? > > > > > > I think it would currently make sense for the current docs page to be > > under that domain. > > > > > > So to enable that, what do we need to do? > > > > > > 1. The current docs are hosted on readthedocs.org -- can we continue to > > use that? or? > > > 2. If so, then we can add a new domain - hamilton.apache.org which > > would require a CNAME target to be added .. > > > 3. If not, the current docs are sphinx docs, how could we migrate them > > to the apache approved place? > > > > > > Cheers, > > > > > > Stefan > >
