Skip to content

docs(blog): zarr 3.4.0 release post - #4355

Open
d-v-b wants to merge 10 commits into
zarr-developers:mainfrom
d-v-b:docs/3.4.0-blog-post
Open

d-v-b wants to merge 10 commits into
zarr-developers:mainfrom
d-v-b:docs/3.4.0-blog-post

Conversation

@d-v-b

@d-v-b d-v-b commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

This is a blog post for the 3.4.0 release. I wrote it. Please have a look!

🤖 AI text below 🤖

Summary

Release blog post for zarr 3.4.0, in the format of the 3.3.0 post: the project becoming a stack of packages (zarr-metadata, zarr-indexing, zarr-http-server, with the chunk-key-encoding, storage and codec packages in flight), the new roadmap, the rectilinear chunk grid improvements, the codec errors that now name the package to install (with a runnable example of the message), and the new msgspec dependency. Contributors are listed by GitHub handle with first-time contributors marked, and the 3.3.0 post gains the same contributor section for its own range, which it had omitted.

The post is marked draft: true in its front matter, so it is excluded from the built site until that line is removed at publication time; the strict docs build passes with it present, the executable example runs under the docs test harness, and the cross-link to the 3.3.0 post was verified to resolve in a build with the draft flag temporarily off.

The post's title uses zarr, not "Zarr-Python", deliberately: with the subpackages, Zarr-Python names the project, and the release is of the zarr package.

For reviewers

Prose is the author's; the rest of the branch is copy edits, links, the codec-error example, and the contributor lists. Remove draft: true when the release is tagged so the post publishes with it.

Author attestation

  • I am a human, these are my changes, and I have reviewed and understood every change and can explain why each is correct.

TODO

  • Add unit tests and/or doctests in docstrings (n/a — the executable example is validated by the docs harness)
  • Add docstrings and API docs for any new/modified user-facing classes and functions (n/a)
  • New/modified features documented in docs/user-guide/*.md (n/a)
  • Changes documented as a new file in changes/ (n/a — blog post, as for 3.3.0)
  • GitHub Actions have all passed
  • Test coverage is 100% (Codecov passes) (n/a)

🤖 Generated with Claude Code

d-v-b and others added 4 commits September 14, 2026 15:01
Headings and front matter in the 3.3.0 house style, with the proposed
highlights, evidence, PR references and snippet ideas as markdown comments
for the prose to be written against. Marked draft: true so it is excluded
from the built site until it is ready.

Assisted-by: ClaudeCode:claude-fable-5-1
… handles

Prose for the stack, roadmap, rectilinear, codec-error and msgspec
sections; typo and grammar fixes; PR/issue links throughout; a runnable
example of the new unknown-codec error; contributors listed by GitHub
handle with first-time contributors marked. The 3.3.0 post gains the
same contributor section for its own release range.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions github-actions Bot added the needs release notes Automatically applied to PRs which haven't added release notes label Sep 14, 2026
@d-v-b
d-v-b marked this pull request as ready for review September 14, 2026 14:25
@d-v-b
d-v-b requested a review from ilan-gold September 14, 2026 14:25

@ilan-gold ilan-gold left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great but I'd love to see it on the website rendered. Otherwise, I don't spot anything out of place

@d-v-b

d-v-b commented Sep 14, 2026

Copy link
Copy Markdown
Contributor Author

This looks great but I'd love to see it on the website rendered. Otherwise, I don't spot anything out of place

i'll take it out of draft, I think that gets you the preview

@ilan-gold ilan-gold left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the lack of intersphinx in markdown (which IIRC is a result of not using sphinx?) kills me! There are so many useful links to have here!

Comment thread docs/blog/posts/3.4.0-release.md Outdated
Comment thread docs/blog/posts/3.4.0-release.md Outdated
print(e)
```

The table lives in `zarr.registry`; if you maintain a package that provides a codec, please add it there.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be awesome to have inter sphinx here or a link, at least! Unrelated, on that page, it is not really clear what the registry is for.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added an internal link to the registry API docs

d-v-b and others added 3 commits September 14, 2026 18:15
@d-v-b
d-v-b requested a review from maxrjones September 14, 2026 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs release notes Automatically applied to PRs which haven't added release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants