Skip to content

Corpus refresh 2026-10-10: User Guide f5676ad..ac82c47, web 0 added, 10 changed, 1 removed, 5 failed - #94

Merged
github-actions[bot] merged 1 commit into
mainfrom
corpus-refresh/2026-10-10-2
Oct 10, 2026
Merged

github-actions[bot] merged 1 commit into
mainfrom
corpus-refresh/2026-10-10-2

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Corpus refresh, 2026-10-10

Merging: every guard passed and golden-set recall did not drop. Deploy is dispatched once this lands on main.

User Guide f5676ad..ac82c47, 33 upstream commits: rcc-uchicago/user-guide@f5676ad...ac82c47
docs/ 51 added, 33 changed, 0 removed
web/ 55 fetched, 0 added, 10 changed, 1 removed, 5 failed

Guards

guard result
tools/corpus_check.py --update passed
ruff check . passed
pytest -q passed
tools/assembly_check.py passed
tools/metrics.py --against (golden-set recall must not drop) passed

What the documents moved

Findings about the documents rather than the code, so the refresh re-measured them into evals/corpus_baseline.json instead of failing, and CI holds the corpus to that file from now on. None of them held up the merge; they are listed so that a page which went empty or stopped being findable is seen.

One page indexed twice (a wasted result slot; the fix is in the scrape)

  • gone: web/midway2.txt#1, web/support-and-services_midway2.txt#1
  • gone: web/midway2.txt#2, web/support-and-services_midway2.txt#2

The same section on different pages (both kept: each cites its own page)

  • new: docs/tutorials/sde2/compute.md#slurm-partitions, docs/tutorials/sde3/compute.md#slurm-partitions
  • new: docs/tutorials/sde2/data-transfer.md#method-1-download-data-from-a-website, docs/tutorials/sde3/data-transfer.md#method-1-download-data-from-a-website
  • new: docs/tutorials/sde2/data-transfer.md#method-2-download-data-from-a-server, docs/tutorials/sde3/data-transfer.md#method-2-download-data-from-a-server

Pages their own title does not find

  • new: docs/software/apps-and-envs/singularity.md
  • new: docs/tutorials/sde3/software.md

Website pages

Added (0)

Changed (10):

Removed (1):

Failed (5):

Redirected (1):

Available, not included (65): in the sitemap and not in web_pages.toml. Add a page under [allow] to start fetching it, or under [deny] to stop it being listed here.

User Guide files

docs/: 51 added, 33 changed, 0 removed
  • added: docs/software/apps-and-envs/binsanity.md
  • added: docs/software/apps-and-envs/cesm.md
  • added: docs/software/apps-and-envs/meshlab.md
  • added: docs/software/apps-and-envs/wrf.md
  • added: docs/tutorials/sde2/compute.md
  • added: docs/tutorials/sde2/connection.md
  • added: docs/tutorials/sde2/data-transfer.md
  • added: docs/tutorials/sde2/images/avd1.png
  • added: docs/tutorials/sde2/images/avd2.png
  • added: docs/tutorials/sde2/images/avd3.png
  • added: docs/tutorials/sde2/images/avd4.png
  • added: docs/tutorials/sde2/images/avd5.png
  • added: docs/tutorials/sde2/images/avd6.png
  • added: docs/tutorials/sde2/images/avd7.png
  • added: docs/tutorials/sde2/images/avd8.png
  • added: docs/tutorials/sde2/images/avd9.png
  • added: docs/tutorials/sde2/images/avd_desktop.png
  • added: docs/tutorials/sde2/images/avd_desktop_add.png
  • added: docs/tutorials/sde2/images/avd_desktop_workspace.png
  • added: docs/tutorials/sde2/images/avd_login.png
  • added: docs/tutorials/sde2/images/avd_webpage.png
  • added: docs/tutorials/sde2/images/avd_winscp.png
  • added: docs/tutorials/sde2/images/box_download.jpg
  • added: docs/tutorials/sde2/images/box_login.jpg
  • added: docs/tutorials/sde2/images/connection.png
  • added: docs/tutorials/sde2/images/connection_sde2.png
  • added: docs/tutorials/sde2/images/downloads.jpg
  • added: docs/tutorials/sde2/images/putty.jpg
  • added: docs/tutorials/sde2/images/putty_confirm.jpg
  • added: docs/tutorials/sde2/images/sde2_tmp.png
  • added: docs/tutorials/sde2/images/tl_2fa.jpg
  • added: docs/tutorials/sde2/images/tl_login.jpg
  • added: docs/tutorials/sde2/images/tl_logout.jpg
  • added: docs/tutorials/sde2/images/tl_terminal.jpg
  • added: docs/tutorials/sde2/images/tl_terminal2.jpg
  • added: docs/tutorials/sde2/images/vdi_desktopicon.jpg
  • added: docs/tutorials/sde2/images/vdi_login.jpg
  • added: docs/tutorials/sde2/images/vdi_logout.jpg
  • added: docs/tutorials/sde2/images/vdi_putty.jpg
  • added: docs/tutorials/sde2/images/vdi_puttyserver.jpg
  • added: docs/tutorials/sde2/images/vdi_puttywarning.jpg
  • added: docs/tutorials/sde2/images/vdi_servername.jpg
  • added: docs/tutorials/sde2/images/winscp.jpg
  • added: docs/tutorials/sde2/images/winscp_hostkey.jpg
  • added: docs/tutorials/sde2/images/winscp_hostkey_sde2.png
  • added: docs/tutorials/sde2/images/winscp_upload1.jpg
  • added: docs/tutorials/sde2/images/winscp_upload1_sde2.png
  • added: docs/tutorials/sde2/images/winscp_upload2.jpg
  • added: docs/tutorials/sde2/images/winscp_upload2_sde2.png
  • added: docs/tutorials/sde2/overview.md
  • added: docs/tutorials/sde2/software.md
  • changed: docs/connection/ssh/main.md
  • changed: docs/connection/thinlinc/troubleshooting.md
  • changed: docs/data_sharing/access_control.md
  • changed: docs/data_sharing/globus_sharing.md
  • changed: docs/data_transfer/cloud/cloud-sync.md
  • changed: docs/ecosystems.md
  • changed: docs/glossary.md
  • changed: docs/slurm/faq.md
  • changed: docs/slurm/main.md
  • changed: docs/slurm/sbatch.md
  • changed: docs/software/apps-and-envs/gaussian.md
  • changed: docs/software/apps-and-envs/gromacs.md
  • changed: docs/software/apps-and-envs/mathematica.md
  • changed: docs/software/apps-and-envs/matlab.md
  • changed: docs/software/apps-and-envs/namd.md
  • changed: docs/software/apps-and-envs/nwchem.md
  • changed: docs/software/apps-and-envs/openmm.md
  • changed: docs/software/apps-and-envs/r.md
  • changed: docs/software/apps-and-envs/scode/environments.md
  • changed: docs/software/apps-and-envs/scode/main.md
  • changed: docs/software/apps-and-envs/scode/python.md
  • changed: docs/software/apps-and-envs/singularity.md
  • changed: docs/software/apps-and-envs/spaceranger.md
  • changed: docs/software/apps-and-envs/tf-and-torch.md
  • changed: docs/software/compilers.md
  • changed: docs/software/faq.md
  • changed: docs/software/index.md
  • changed: docs/storage/main.md
  • changed: docs/stylesheets/extra.css
  • changed: docs/tutorials/kicp.md
  • changed: docs/tutorials/sde3/compute.md
  • changed: docs/tutorials/sde3/data-transfer.md
  • changed: docs/tutorials/sde3/overview.md

Retrieval metrics, before and after

retrieval: golden set (n=36)
   recall@5  100.0%  (+0.0%)
   recall@3  100.0%  (+0.0%)
   p@1        88.9%  (+0.0%)
   MRR        0.944  (+0.005)
   depth      2.278  (+0.000)
   better: 'what clusters does RCC run' 3 -> 2
retrieval: + known gaps (n=38)
   recall@5  100.0%
   recall@3  100.0%
   p@1        84.2%
   MRR        0.921
   depth      2.237

corpus_check

What the refreshed corpus can and cannot answer
corpus     636 chunks
   docs     80 pages   545 chunks     432.1k chars
   kb        1 pages     9 chunks       4.7k chars
   web      42 pages    82 chunks     131.1k chars

empty documents (2): topics nothing can answer
       0 bytes  docs/data_transfer/cloud/rclone.md
     188 bytes  web/takecourse.txt

indexed nothing (1): read, and no section came out
   docs/data_transfer/cloud/rclone.md
   -> asked by outcome rather than by file size, so a reader that stops recognising a heading style shows up here rather than nowhere.

duplicate sections   one page indexed twice 0   shared boilerplate 5   near-duplicate pairs 0 (0 across sources)
   shared boilerplate (keep both, they cite different pages): ['docs/tutorials/sde2/compute.md#slurm-partitions', 'docs/tutorials/sde3/compute.md#slurm-partitions']
   shared boilerplate (keep both, they cite different pages): ['docs/tutorials/sde2/data-transfer.md#method-1-download-data-from-a-website', 'docs/tutorials/sde3/data-transfer.md#method-1-download-data-from-a-website']
   shared boilerplate (keep both, they cite different pages): ['docs/tutorials/sde2/data-transfer.md#method-2-download-data-from-a-server', 'docs/tutorials/sde3/data-transfer.md#method-2-download-data-from-a-server']
   shared boilerplate (keep both, they cite different pages): ['docs/data_sharing/databases/bfi.md#method-2-globus', 'docs/data_sharing/databases/booth.md#method-2-globus']
   shared boilerplate (keep both, they cite different pages): ['docs/data_sharing/databases/bfi.md#method-3-ssh-scp-sftp-etc', 'docs/data_sharing/databases/booth.md#method-3-ssh-scp-sftp-etc']

reachability   204 of 636 chunks surfaced by 79 questions
   NOT MEASURABLE: 79 questions x 6 results is a ceiling of 474 chunks, below the 636 indexed. A percentage here would describe the question set, not the index.
   asked for by its own title: 98.4% of 123 pages are retrievable (2 are not)
      unreachable: docs/software/apps-and-envs/singularity.md  (titled 'Modules')
      unreachable: docs/tutorials/sde3/software.md  (titled 'Software')

topics the profile advertises
   ok         32.1  accounts       -> accounts-allocations.txt
   ok         25.8  connecting     -> connection/ssh/main.md
   CAVEATED   11.5  Slurm          -> slurm/main.md
   CAVEATED   16.5  storage        -> storage/main.md
   ok         26.9  software       -> tutorials/sde2/software.md
   ok         36.0  GPUs           -> software/compilers.md
   ok         25.9  policy         -> about-rcc_rcc-user-policy.txt
   -> a one-word query scores low because the floor is an unnormalised sum, not because the topic is missing. Worth knowing: a reader who types one word gets the caveat.

integrity   ids that do not resolve 0   chunks with no URL 9   unusable URLs 0
   no url: kb/thinlinc-login-problems.md#thinlinc-will-not-connect
   no url: kb/thinlinc-login-problems.md#login-fails-or-logs-you-straight-back-out
   no url: kb/thinlinc-login-problems.md#server-disconnected-after-logging-in
   no url: kb/thinlinc-login-problems.md#the-desktop-opens-but-the-display-is-wrong
   no url: kb/thinlinc-login-problems.md#no-agent-available

freshness  {"refreshed_at": "2026-10-10 20:30 UTC", "user_guide_commit": "ac82c47", "docs_files": 81, "web_files": 54, "web_refreshed_at": "2026-10-10 20:30 UTC", "sitemap_urls": 101, "web_pages_fetched": 55, "web_pages_changed": 10, "web_pages_removed": 1, "web_pages_failed": 5}

baseline   evals/corpus_baseline.json rewritten; 3 finding(s) moved
   same_page_twice: 0 appeared, 2 went
      - ['web/midway2.txt#1', 'web/support-and-services_midway2.txt#1']
      - ['web/midway2.txt#2', 'web/support-and-services_midway2.txt#2']
   shared_boilerplate: 3 appeared, 0 went
      + ['docs/tutorials/sde2/compute.md#slurm-partitions', 'docs/tutorials/sde3/compute.md#slurm-partitions']
      + ['docs/tutorials/sde2/data-transfer.md#method-1-download-data-from-a-website', 'docs/tutorials/sde3/data-transfer.md#method-1-download-data-from-a-website']
      + ['docs/tutorials/sde2/data-transfer.md#method-2-download-data-from-a-server', 'docs/tutorials/sde3/data-transfer.md#method-2-download-data-from-a-server']
   unfindable_by_title: 2 appeared, 0 went
      + docs/software/apps-and-envs/singularity.md
      + docs/tutorials/sde3/software.md

Opened by .github/workflows/refresh-corpus.yml; CI does not run on pull requests a workflow opens, so the guards above ran in that workflow.

…10 changed, 1 removed, 5 failed

User Guide f5676ad..ac82c47, 33 upstream commits: rcc-uchicago/user-guide@f5676ad...ac82c47.
docs/: 51 added, 33 changed, 0 removed.
Website: 55 of 55 listed pages fetched; 0 added, 10 changed, 1 removed, 5 failed; 65 sitemap pages available, not included.
Re-measured into evals/corpus_baseline.json: same_page_twice +0 -2; shared_boilerplate +3 -0; unfindable_by_title +2 -0.

Opened by .github/workflows/refresh-corpus.yml.
@github-actions
github-actions Bot merged commit 87e7f8c into main Oct 10, 2026
@github-actions
github-actions Bot deleted the corpus-refresh/2026-10-10-2 branch October 10, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants