changelog: add missing odoc releases (#3248)

Author: sabine

data/changelog/releases/odoc/2024-09-13-odoc-2.4.3.md

@@ -0,0 +1,27 @@
+---
+title: Odoc 2.4.3
+tags:
+- odoc
+- platform
+authors:
+contributors:
+changelog: |
+    ### Fixed
+
+    *   Fix missing katex headers ([@panglesd](https://github.com/panglesd), [#1096](https://github.com/ocaml/odoc/pull/1096))
+    *   Allow `][` in code blocks, fixing issue [#1137](https://github.com/ocaml/odoc/issues/1137) ([@Julow](https://github.com/Julow), [#1149](https://github.com/ocaml/odoc/pull/1149))  
+        This was interpreted as "code blocks with result", which now mandates a  
+        delimiter: `{delim@lang[ code ]delim[ result ]}`
+    *   Fix misprinting of type variables from ml files for OCaml 4.14 and later  
+        (multiple occurences of the same type variable could be named differently)  
+        ([@Octachron](https://github.com/Octachron), [#1173](https://github.com/ocaml/odoc/pull/1173))
+versions:
+unstable: false
+ignore: false
+github_release_tags:
+- 2.4.3
+---
+
+We're happy to announce the release of Odoc 2.4.3!
+
+This release includes three key fixes: we restored missing KaTeX headers for proper mathematical rendering, resolved an issue where `][` characters in code blocks were incorrectly interpreted as "code blocks with result" (now requiring explicit delimiters), and corrected the misprinting of type variables from ML files in OCaml 4.14 and later versions where multiple instances of the same type variable could be displayed with different names.

data/changelog/releases/odoc/2024-12-05-odoc-2.4.4.md

@@ -0,0 +1,19 @@
+---
+title: Odoc 2.4.4
+tags:
+- odoc
+- platform
+authors:
+contributors:
+changelog: |
+    ### Added
+
+    *   OCaml 5.3.0 compatibility ([@Julow](https://github.com/Julow), [#1202](https://github.com/ocaml/odoc/pull/1202), [#1254](https://github.com/ocaml/odoc/pull/1254))
+versions:
+unstable: false
+ignore: false
+github_release_tags:
+- 2.4.4
+---
+
+We're happy to announce the release of Odoc 2.4.4 which brings compatibility with OCaml 5.3!

data/changelog/releases/odoc/2025-03-20-odoc-3.0.0.md

@@ -1,5 +1,5 @@
 ---
-title: Odoc 3.0
+title: Odoc 3.0.0
 tags: [odoc, platform]
 github_release_tags: [3.0.0]
 changelog: |

data/changelog/releases/odoc/2025-07-15-odoc-3.1.0.md

@@ -0,0 +1,97 @@
+---
+title: Odoc 3.1.0
+tags:
+- odoc
+- platform
+authors:
+contributors:
+changelog: |
+    ### Added
+
+    *   Exposed sherlodoc libraries for use in other projects ([@jonludlam](https://github.com/jonludlam), [#1349](https://github.com/ocaml/odoc/pull/1349))
+    *   OCaml 5.4.0 support ([@Octachron](https://github.com/Octachron), [#1355](https://github.com/ocaml/odoc/pull/1355))
+    *   New arguments to LaTeX generator, --shorten-beyond-depth and  
+        \--remove-functor-arg-link ([@Octachron](https://github.com/Octachron), [#1337](https://github.com/ocaml/odoc/pull/1337))
+    *   New experimental markdown generator ([@davesnx](https://github.com/davesnx), [#1341](https://github.com/ocaml/odoc/pull/1341))
+
+    ### Changed
+
+    *   Remove cmdliner compatibility layer, no longer needed ([@dbuenzli](https://github.com/dbuenzli), [#1328](https://github.com/ocaml/odoc/pull/1328))
+    *   Drop support for OCaml < 4.08 ([@jonludlam](https://github.com/jonludlam), [#1300](https://github.com/ocaml/odoc/pull/1300))
+    *   Allow referencing libraries from package added in `odoc-config.sexp`  
+        ([@panglesd](https://github.com/panglesd), [#1343](https://github.com/ocaml/odoc/pull/1343))
+    *   Use full path in heading labels in LaTeX backend ([@Octachron](https://github.com/Octachron), [#1332](https://github.com/ocaml/odoc/pull/1332))
+    *   Separate page from anchor in LaTeX labels to prevent collisions ([@Octachron](https://github.com/Octachron),  
+        [#1337](https://github.com/ocaml/odoc/pull/1337))
+
+    ### Fixed
+
+    *   Fix bug in parsing META files when there are no dependencies ([@jonludlam](https://github.com/jonludlam), [#1352](https://github.com/ocaml/odoc/pull/1352))
+    *   Fix [#1335](https://github.com/ocaml/odoc/issues/1335) - incorrect rendering when on medium screen size with no global  
+        sidebar ([@lukemaurer](https://github.com/lukemaurer), [#1361](https://github.com/ocaml/odoc/pull/1361))
+    *   Fixed generation of occurrences for docs CI ([@jonludlam](https://github.com/jonludlam), [#1362](https://github.com/ocaml/odoc/pull/1362))
+    *   Partial fix for [#1369](https://github.com/ocaml/odoc/issues/1369) - ensure that we never create a link to a hidden page  
+        ([@jonludlam](https://github.com/jonludlam), [#1370](https://github.com/ocaml/odoc/pull/1370))
+versions:
+unstable: false
+ignore: false
+github_release_tags:
+- 3.1.0
+---
+
+We're excited to announce the release of odoc 3.1.0! This release brings several new features, important improvements, and bug fixes to OCaml's documentation generator.
+
+## What's New
+
+### OCaml 5.4.0 Compatibility
+Full support for OCaml 5.4.0 has been added, ensuring odoc stays current with the latest OCaml releases.
+
+### New Output Formats and Options
+- **Enhanced LaTeX Generator**: New command-line arguments `--shorten-beyond-depth` and `--remove-functor-arg-link` provide more control over LaTeX output formatting
+
+## Key Improvements
+
+### Modernized Dependencies
+The cmdliner compatibility layer has been removed as it's no longer needed, simplifying the codebase and reducing maintenance overhead.
+
+### Updated System Requirements  
+Support for OCaml versions prior to 4.08 has been dropped, allowing the project to leverage more modern language features and reduce compatibility complexity.
+
+### Better Configuration Management
+Libraries from packages can now be referenced when added in `odoc-config.sexp`, improving flexibility in documentation project setup.
+
+### Improved LaTeX Output
+- Heading labels now use full paths to improve navigation and reference accuracy
+- Page and anchor separation in LaTeX labels prevents naming collisions
+
+## Bug Fixes
+
+This release addresses several important issues:
+- Fixed META file parsing when dependencies are absent
+- Resolved rendering problems on medium screen sizes without global sidebar
+- Corrected occurrence generation for documentation CI systems  
+- Ensured hidden pages never receive links, preventing broken references
+
+## Getting Started
+
+To install odoc 3.1.0:
+
+```bash
+opam install odoc
+```
+
+For existing users, upgrade with:
+
+```bash
+opam upgrade odoc
+```
+
+## Contributors
+
+Special thanks to all contributors who made this release possible: [@jonludlam](https://github.com/jonludlam), [@Octachron](https://github.com/Octachron), [@davesnx](https://github.com/davesnx), [@dbuenzli](https://github.com/dbuenzli), [@panglesd](https://github.com/panglesd), and [@lukemaurer](https://github.com/lukemaurer).
+
+## What's Next
+
+We continue to work on expanding odoc's capabilities and improving documentation generation. The development team remains committed to making OCaml documentation more accessible and comprehensive.
+
+Happy documenting!