From b479781f4f3646cc0a2bef49e4b1b0525e27729f Mon Sep 17 00:00:00 2001
From: jsjiang <jing.jiang@ucop.edu>
Date: Wed, 26 Aug 2026 15:18:50 -0700
Subject: [PATCH 1/4] testing jekyll build

---
 .github/workflows/jekyll-build.yml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 .github/workflows/jekyll-build.yml

diff --git a/.github/workflows/jekyll-build.yml b/.github/workflows/jekyll-build.yml
new file mode 100644
index 0000000..e49bca3
--- /dev/null
+++ b/.github/workflows/jekyll-build.yml
@@ -0,0 +1,28 @@
+name: Jekyll Build
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4.10"
+          bundler-cache: true
+
+      - name: Build site
+        run: bundle exec jekyll build --destination _site
+
+      - name: Upload built site
+        uses: actions/upload-artifact@v4
+        with:
+          name: site
+          path: _site

From 27f3c5c54779d5ad163d4d8e0c9e34b5b7e21851 Mon Sep 17 00:00:00 2001
From: jsjiang <jing.jiang@ucop.edu>
Date: Wed, 26 Aug 2026 15:28:28 -0700
Subject: [PATCH 2/4] remove upload built site task

---
 .github/workflows/jekyll-build.yml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.github/workflows/jekyll-build.yml b/.github/workflows/jekyll-build.yml
index e49bca3..36caedf 100644
--- a/.github/workflows/jekyll-build.yml
+++ b/.github/workflows/jekyll-build.yml
@@ -21,8 +21,3 @@ jobs:
       - name: Build site
         run: bundle exec jekyll build --destination _site
 
-      - name: Upload built site
-        uses: actions/upload-artifact@v4
-        with:
-          name: site
-          path: _site

From d0ac23610f437a5490653db24c380f94f5749240 Mon Sep 17 00:00:00 2001
From: jsjiang <jing.jiang@ucop.edu>
Date: Wed, 26 Aug 2026 16:13:41 -0700
Subject: [PATCH 3/4] add jekyll build instructions to readme

---
 README | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 1 deletion(-)

diff --git a/README b/README
index 4cf64e3..ad04807 100644
--- a/README
+++ b/README
@@ -1,3 +1,68 @@
 # arks.org
 
-Built with Jekyll.
+This site is built with Jekyll.
+
+## Build environment
+
+The project uses:
+
+- Ruby 3.4.10, selected by `.ruby-version`
+- Bundler 2.6.9, recorded in `Gemfile.lock`
+- Jekyll 4.4.1 or later within the `Gemfile` constraint
+
+## Install Ruby
+
+Install Ruby 3.4.10 using a Ruby version manager, `rbenv` for example.
+From the project directory, run:
+
+```sh
+rbenv install 3.4.10
+rbenv local 3.4.10
+ruby --version
+```
+
+The last command should report Ruby 3.4.10. 
+
+## Install dependencies
+
+Install the Bundler version recorded in the lockfile, then install the locked gems:
+
+```sh
+gem install bundler -v 2.6.9
+bundle --version
+bundle install
+```
+
+Verify the resolved Jekyll version:
+
+```sh
+bundle exec jekyll --version
+```
+
+The current lockfile resolves Jekyll 4.4.1. To intentionally update dependencies after changing `Gemfile`, run:
+
+```sh
+bundle update
+```
+
+## Build the site
+
+Generate the static site in `_site/`:
+
+```sh
+bundle exec jekyll build --destination _site
+```
+
+The `_site/` directory is generated output and should not be edited directly.
+
+## Preview locally
+
+Start a local server with live reload:
+
+```sh
+bundle exec jekyll serve --livereload
+```
+
+Open <http://localhost:4000/arks.github.io/> in a browser.
+
+

From f281e332a91ff474b07e0276d6736fdfa86af6ca Mon Sep 17 00:00:00 2001
From: jsjiang <jing.jiang@ucop.edu>
Date: Wed, 26 Aug 2026 16:24:47 -0700
Subject: [PATCH 4/4] upgrade github actions/checkout to v4

---
 .github/workflows/jekyll-build.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/jekyll-build.yml b/.github/workflows/jekyll-build.yml
index 36caedf..e28ee3a 100644
--- a/.github/workflows/jekyll-build.yml
+++ b/.github/workflows/jekyll-build.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1