Meeting Summary & Minutes
Date: May 26, 2025
Attendees: @cbull, @dougiesquire, @anton, @aekiss, @AndyHoggAnu, @pearseb, @helen, @MartinDix, @spencerwong
ACCESS OM3 Config Docs
Chris demonstrated the config documentation system. The docs are versioned, written in Markdown for easy transferability, and will support citability with an automatically updated DOI upon each config release. Chris also proposed generating a full PDF version. The implementation involves a repository with a structured skeleton where the actual documentation is stored in Markdown files.
Current ACCESS OM3 config docs are located here: access-om3-configs/docs at davide/docs-setup · ACCESS-NRI/access-om3-configs · GitHub
Related issues:
- User documentation for ACCESS OM3 025 release. · Issue #472 · ACCESS-NRI/access-om3-configs · GitHub
- User documentation for ACCESS OM3 025 release. · Issue #472 · ACCESS-NRI/access-om3-configs · GitHub
- Documentation · COSIMA/access-om3 · Discussion #120 · GitHub
- Splitting up contribute/contribute_on_github/ workflow into quick and easy versus advanced · Issue #907 · ACCESS-NRI/access-hive.org.au · GitHub
New Website Structuring Approach
Chris proposed a new website structure where docs live alongside the code, with the main branch holding general info and config details in separate branches, to minimise redundancy and supports community edits.
Repo Search & Configs Discussion
Andrew explained the use of repo search links in the docs. Chris and Andy discussed dynamic linking, MathJax for equations, and a standardized config subdomain.
Chris emphasized proper work attribution and linking commits to work.
Versioning & Updates
Chris and Andy highlighted the need for flexible versioning to handle updates across releases while ensuring accuracy for older configurations.
Restart Reproducibility
Dougie identified that the Mom symmetric restart reproducibility issue comes from changes ACCESS-NRI have made to the MOM NUOPC cap. Hopefully an easy fix.
Andy inquired about patches, and Dougie confirmed they are in a PR candidate branch, queued for upstreaming.
Incoming MOM6 PR from NCAR
- There’s an open PR to MOM6 main that impacts OM3
- Dougie has suggested changes to that PR. One accepted already, one hopefully accepted soon.
OM3 configs consolidation
- All OM3 configurations are now in access-om3-configs.
- access-om3-configs and access-om3-wav-configs were merged.
- access-om3-wav-configs repo has been archived.
- All issues have been moved from COSIMA/access-om3 to ACCESS-NRI/access-om3-configs
- Moving issues to access-om3-configs sent an email to everyone that engaged in an issue for every issue.
- Dougie suggested mentioning emails in COSIMA WG meeting tomorrow in case anyone is confused.
One API Release:
Anton plans to skip the old COSIMA build system and transition to the new one, as test results were identical.
Action Items
- Chris: Create a release checklist template for the ocean team on the forum.
- Dougie: Fix the restart reproducibility issue in MOM symmetric.
Note: I might have missed something, please feel free to edit.