From 2dd672e519d16a62510ccdb27c1df905a407aa90 Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Wed, 24 Jul 2024 06:43:03 -0400 Subject: [PATCH] Minor: add publishing instructions --- README.md | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d75e91c..e3a6333 100644 --- a/README.md +++ b/README.md @@ -38,4 +38,30 @@ bundle exec jekyll serve ## Publish site -TBD, but create the html with `bundle exec jekyll build` then check the content into `asf-site` branch \ No newline at end of file +This is currently a manual process. Basic steps are: + +#### Check out `main` and build site +```shell +# Check out latest code +git checkout main +git pull +# build site (html is left in _site directory) +bundle exec jekyll build +``` + +#### Check out `asf-site` and copy content +Checkout a separate copy of `datafusion-site` + +```shell +git checkout asf-site +git pull +# create a branch for the publishing +git checkout -b publish_blog +# copy content built from _site directory +cp -R ../datafusion-site/_site/* . +git commit -a -m 'Publish blog content' +``` + +#### Make PR, targeting the `asf-site` branch +For example, see https://github.com/apache/datafusion-site/pull/9 +