Skip to content

Conversation

sabine
Copy link
Collaborator

@sabine sabine commented Aug 27, 2025

what Before After
OCaml Changelog Screenshot 2025-08-27 at 16-43-16 OCaml Changelog Screenshot 2025-08-27 at 16-43-27 OCaml Changelog
Backstage OCaml didn't exist Screenshot 2025-08-27 at 16-43-33 Backstage OCaml

Changes:

  • Introduced "Backstage OCaml" - A new content category for unstable/experimental communications, separating them from the main OCaml Changelog
  • Created three-tier content organization: OCaml Changelog, Backstage OCaml, and Platform Tools Releases. (Refactored Platform Releases out of tools/ood-gen/lib/changelog.ml into tools/ood-gen/lib/platform_tools_release.ml, Introduced tools/ood-gen/backstage.ml, which considers unstable OCaml Platform Releases and posts from data/backstage, while tools/ood-gen/changelog.ml considers stable OCaml Platform Releases and posts from data/changelog)
  • Moved all existing posts either under data/changelog/ or data/backstage/ and all the platform tools release announcements under data/platform_tools_releases/.
  • Add redirects for former OCaml Changelog posts which are now sorted under Backstage OCaml (Dune Developer Preview, and Infrastructure announcements)
  • Updated CONTRIBUTING.md to reflect OCaml Changelog / Backstage OCaml / Platform Tools Releases triad
  • Update the OCaml Platform Tool release scraper to work with the new structure

Todo:

  • very carefully deal with URL structure and redirects (if we're placing backstage posts under /backstage/, we need to redirect the relevant old posts from /changelog/ to their new URLs!)
  • update contributor docs for maintainers who add releases and Backstage OCaml and OCaml Changelog posts
  • [ ] place one big feed that aggregates everything (OCaml Changelog, Backstage OCaml, OCaml Planet, Newsletters) under /feed.xml, instead of redirecting to the OCaml Planet (let's do this as a separate issue/task)

After Merge:

  • Update social media integrations to distribute Backstage OCaml content under appropriate framing (unstable / experimental / behind the scenes / contributor-relevant)

@sabine sabine force-pushed the split_ocaml_changelog_and_backstage_ocaml branch 4 times, most recently from 7090678 to efc351a Compare August 27, 2025 14:41
@sabine sabine force-pushed the split_ocaml_changelog_and_backstage_ocaml branch from fd836e7 to d25265c Compare September 10, 2025 15:02
@sabine sabine marked this pull request as ready for review September 10, 2025 15:25
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.

1 participant