Review ARKs documentation

[jsjiang]

Review ARKs documentation

• readme: https://github.com/CDLUC3/arksorg-site
• files under the doc_src folder:
  • how to use the .puml files such as component_diagram.puml
• the operation test file

Questions:

• are they up-to-date
• any docs in other places
• anything else need to be documented

[jsjiang]

Review items/pages:

• readme: https://github.com/CDLUC3/arksorg-site

[jsjiang]

Anything else that need to be documented:

• troubleshooting tips
  • for example: how to respond to jekyll update failure

Error message from ezidarks-prd02 on Sept 24:

From: (Cron Daemon) <ezid@uc3-ezidarks-prd02.cdlib.org>
Date: Wednesday, September 24, 2025 at 8:17 PM
To: ezid@uc3-ezidarks-prd02.cdlib.org <ezid@uc3-ezidarks-prd02.cdlib.org>
Subject: Cron <ezid@uc3-ezidarks-prd02> /ezid/bin/run_jekyll_update_from_cron.sh

PLAY [all] *********************************************************************

TASK [Gathering Facts] *********************************************************
ok: [localhost]

TASK [Run git pull on arks.github.io repo] *************************************
fatal: [localhost]: FAILED! => {
    "changed": false,
    "cmd": "/usr/bin/git ls-remote origin -h refs/heads/main",
    "rc": 128
}

STDERR:

fatal: unable to access 'https://github.com/arks-org/arks.github.io.git/': Failed to connect to github.com port 443 after 132977 ms: Could not connect to server