Skip to content

Conversation

@bmribler
Copy link
Collaborator

@bmribler bmribler commented Nov 5, 2025

The page is still a draft because the links are not ready, but the PR can be reviewed for the changes so far.

@bmribler bmribler requested a review from lrknox November 5, 2025 05:15
| Version | HDF5 2.0 |
| Release Date | 11/10/25 |
| Additional Release Information | [Release Notes](https://github.com/HDFGroup/hdf5/blob/hdf5_2_0/release_docs/RELEASE.txt) |
|| [Software Changes from Release to Release](http://support.hdfgroup.org/releases/hdf5/documentation/release_specifics/sw_changes_2.md) |
Copy link
Collaborator

Choose a reason for hiding this comment

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

| Release Date | 11/10/25 |
| Additional Release Information | [Release Notes](https://github.com/HDFGroup/hdf5/blob/hdf5_2_0/release_docs/RELEASE.txt) |
|| [Software Changes from Release to Release](http://support.hdfgroup.org/releases/hdf5/documentation/release_specifics/sw_changes_2.md) |
|| [New Features in HDF5 Release 2](http://support.hdfgroup.org/releases/hdf5/documentation/release_specifics/new_features_2.md) |
Copy link
Collaborator

Choose a reason for hiding this comment

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


## Release Information

| Version | HDF5 2.0 |
Copy link
Collaborator

Choose a reason for hiding this comment

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

version 2.0.0


| Version | HDF5 2.0 |
| Release Date | 11/10/25 |
| Additional Release Information | [Release Notes](https://github.com/HDFGroup/hdf5/blob/hdf5_2_0/release_docs/RELEASE.txt) |
Copy link
Collaborator

Choose a reason for hiding this comment

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

404
wrong branch?
File also doesn't exist in hdf5_2_0_0 branch?

**Methods to obtain (gz file)**
* firefox – Download file and then run: `gzip <distribution>.tar.gz | tar xzf -`
* chrome – Download file and then run: `gzip -cd <distribution>.tar.gz | tar xvf -`
* `wget – wget https://github.com/HDFGroup/hdf5/releases/download/hdf5_1.N.N/<distribution>.tar.gz`
Copy link
Collaborator

Choose a reason for hiding this comment

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

this is an example wget command - can we avoid the link rendering as an active link.
Perhaps Insert a zero‑width space after the colon to break auto-linking: wget https:​//github.com/HDFGroup/hdf5/releases/download/hdf5_1.N.N/.tar.gz


The new HDF5 documentation based on [Doxygen](https://www.doxygen.nl/index.html) is available [here](https://support.hdfgroup.org/releases/hdf5/v2/index.html)

This documentation is WORK-IN-PROGRESS.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Remove this line.
I don't see the need to make these statements.


This documentation is WORK-IN-PROGRESS.

Since this portion of the HDF5 documentation is now part of the source code, it gets the same treatment as code. In other words, issues, inaccuracies, corrections should be reported as issues in [GitHub](https://github.com/HDFGroup/hdf5/issues), and pull requests will be reviewed and accepted as any other code changes.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Unneeded historical background. Simplify the reporting instructions. If they are even needed.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I've been wanting to remove it. There is a mention of where to report documentation issue in the documentation itself. Or, I can change this to a one-line notice too.

Copy link
Collaborator

@lkurz lkurz left a comment

Choose a reason for hiding this comment

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

We should probably abandon this PR.
And new PR to change the https://support.hdfgroup.org/downloads/index.html entry for hdf5 to redirect into doxygen.

https://support.hdfgroup.org/documentation/hdf5/latest/rel_spec_20.html

On the Doxygen side the release is 2.0 not 2.0.0 ??

@bmribler bmribler closed this Nov 17, 2025
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.

2 participants