Skip to content

Update documentation to OasisLMF/OasisPlatform 2.5.4#47

Open
benhayes21 wants to merge 1 commit into
mainfrom
update/docs-for-2.5.4
Open

Update documentation to OasisLMF/OasisPlatform 2.5.4#47
benhayes21 wants to merge 1 commit into
mainfrom
update/docs-for-2.5.4

Conversation

@benhayes21

Copy link
Copy Markdown
Contributor

Summary

  • Bumps PLAT_VER in update-redoc.py from 2.5.0 → 2.5.4 and regenerates all four OpenAPI/settings JSON schemas
  • Replaces stale 1.4.x OasisLMF changelog and broken OasisPlatform include directive with full 2.5.0–2.5.4 changelogs
  • Updates Python minimum requirement 3.8 → 3.10 across all relevant pages
  • Documents new oasislmf CLI subcommands (generate-pre-loss, generate-post-file-gen, generate-losses-chunk, generate-losses-output, run-postanalysis, generate-doc, warmup, API client commands)
  • Adds macOS Apple Silicon installation section and JIT cache warmup guide
  • Updates ods_tools compatibility table (adds 3.2.x, 4.0.x, 5.0.x entries); rewrites ODS-tools page with combine and generate commands
  • Fixes broken/stale OED links (repo moved from OpenDataStandardsODS_OpenExposureData, docs reorganised under Docs/); updates spec format reference xlsx → CSV (OEDInputFields.csv, v4.0.0+); adds Marine Cargo section
  • Updates container_configuration.rst: psycopg2 → psycopg driver string, API_AUTH_TYPE=disabled, server-internal RUN_MODE, Celery SSL/TLS env vars (v2.5.2+)
  • Updates distributed_execution.rst: renames ktools_*kernel_* params (v2.5.3), removes raw_output_locations (removed in v2.5.4)
  • Adds four new model entries to Oasis-models page: Dynamic Footprint, PiWind Vulnerability Adjustments, PiWind S3, PiWind Azure

Test plan

  • Run make html in GenerateDocs/ to verify Sphinx build passes without errors
  • Check all new changelog links resolve to valid GitHub PRs
  • Verify regenerated JSON schemas in src/schema/ match OasisPlatform 2.5.4 release

🤖 Generated with Claude Code

Brings all docs in sync with the 2.5.x release series:

- Bump PLAT_VER in update-redoc.py from 2.5.0 → 2.5.4 and regenerate
  all four OpenAPI/settings JSON schemas
- Add 2.5.0–2.5.4 changelogs for OasisLMF and OasisPlatform (replacing
  the stale 1.4.x history and the broken include directive)
- Update Python minimum requirement 3.8 → 3.10
- Document new oasislmf CLI subcommands, utility commands (warmup,
  config, version, admin, test), and API client commands
- Add macOS Apple Silicon installation section and JIT cache warmup guide
- Update ods_tools compatibility table to include 3.2.x/4.0.x/5.0.x
- Rewrite ODS-tools page: add combine and generate commands, update
  convert/check option lists
- Fix OED page: broken/stale links, xlsx → CSV spec (v4.0.0), add
  marine cargo section, fix repo path changes
- container_configuration.rst: update psycopg driver string, add
  API_AUTH_TYPE=disabled, server-internal RUN_MODE, Celery SSL/TLS vars
- distributed_execution.rst: rename ktools_* → kernel_*, remove
  raw_output_locations (removed in 2.5.4)
- Oasis-models.rst: add Dynamic Footprint, PiWind Vulnerability
  Adjustments, PiWind S3, and PiWind Azure model entries

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://OasisLMF.github.io/PreviewDocs/pr-preview/pr-47/

Built to branch gh-pages at 2026-06-12 11:02 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@sambles sambles mentioned this pull request Jun 12, 2026
@sambles sambles self-requested a review June 12, 2026 13:31
@sambles

sambles commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Thanks for fixing, i made a note to do this. (but forgot)

Comments:

  • Do we use the files releases/oasis_platform.rst releases/oasislmf.rst? might be better to ditch these and link to the release note pages, seems a pain to keep inline

  • I don't think the schema/< json file> data is needed. The schema viewers pulls then info from a url (but dosen't hurt to have a copy)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

3 participants