Skip to content

Conversation

@matsduf
Copy link
Contributor

@matsduf matsduf commented Dec 16, 2025

Purpose

This PR updates Changes and docs/public/RELEASE.md with the same content.

How to test this PR

Review.

@matsduf matsduf added this to the v2025.2 milestone Dec 16, 2025
@matsduf matsduf added A-Documentation Area: Documentation only. P-High Priority: Issue to be solved before other RC-None Release category: Not to be included in Changes file. labels Dec 16, 2025
Co-authored-by: Marc van der Wal <[email protected]>
Changes Outdated
Zonemaster-Backend.
- Customization in GUI of previous version requires migration for this
version. See Zonemaster-GUI.
- The Zonemaster URL API has changed. See "using GUI" documentation.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm wondering if we could just provide direct links to the actual documents in such sentences. What do you think?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I will update with that. Such a link will be broken before release so please check thoroughly. Safest to link to Github, not doc.zonemaster.net.

Copy link
Contributor

Choose a reason for hiding this comment

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

It looks like you went the other way in the end, links to doc.zonemaster.net. Either should work, but I think I agree and it might be better to link to Github instead for these files. What do you think?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The links to doc.zonemaster.net are much shorter. I felt the other ones will be too long. In "Changes" the must be visiable. In "RELEASE.md" they could be hidden under some other link name but then the two files are more different than they should be.

Compare:

https://doc.zonemaster.net/v2025.2/configuration/gui/README.md
https://github.com/zonemaster/zonemaster/blob/master/docs/public/configuration/README.md

@matsduf matsduf requested review from marc-vanderwal and tgreenx and removed request for marc-vanderwal December 17, 2025 14:14
marc-vanderwal
marc-vanderwal previously approved these changes Dec 17, 2025

### \[Release information\]
- Translations have not been fully updated in this release. They will be updated in an upcoming extra release.
- The GUI in this release has been completely rewritten. Customization has been greatly extended. See Zonemaster-GUI and <https://doc.zonemaster.net/v2025.2/configuration/gui/README.md>.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- The GUI in this release has been completely rewritten. Customization has been greatly extended. See Zonemaster-GUI and <https://doc.zonemaster.net/v2025.2/configuration/gui/README.md>.
- The GUI in this release has been completely rewritten. Customization has been greatly extended. See Zonemaster-GUI and [Configuring GUI] document.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think we spend too much time on cosmetic changes on this file.

Comment on lines 10 to 11
- Customization of GUI from previous versions requires a migration for this version. See Zonemaster-GUI and <https://doc.zonemaster.net/v2025.2/configuration/gui/README.md>.
- The Zonemaster URL API has changed. See <https://doc.zonemaster.net/v2025.2/using/gui/api.html>.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- Customization of GUI from previous versions requires a migration for this version. See Zonemaster-GUI and <https://doc.zonemaster.net/v2025.2/configuration/gui/README.md>.
- The Zonemaster URL API has changed. See <https://doc.zonemaster.net/v2025.2/using/gui/api.html>.
- Customization of GUI from previous versions requires a migration for this version. See Zonemaster-GUI and [Configuring GUI] document.
- The Zonemaster URL API has changed. See [Configuring GUI API] document.

[NOTICE]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/SeverityLevelDefinitions.md#notice
[WARNING]: https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/SeverityLevelDefinitions.md#warning


Copy link
Contributor

@tgreenx tgreenx Dec 17, 2025

Choose a reason for hiding this comment

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

Suggested change
[Configuring GUI]: https://doc.zonemaster.net/v2025.2/configuration/gui/README.html
[Configuring GUI API]: https://doc.zonemaster.net/v2025.2/configuration/gui/api.html
[Using Docker Backend]: https://doc.zonemaster.net/v2025.2/using/backend/Using-Zonemaster-Backend-Docker.html

- Updates "Requirements and normalization of domain names in input" to make removal of leading and trailing space optional ([#1260]).
- Defines Backend API "batch\_status" to replace "get\_batch\_job\_result" ([#1304]). For implementation see [Zonemaster-Backend].

- Adds Dockerfile and Docker image for Backend. See Zonemaster-Backend and <https://doc.zonemaster.net/v2025.2/using/backend/Using-Zonemaster-Backend-Docker.md> (#1441)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- Adds Dockerfile and Docker image for Backend. See Zonemaster-Backend and <https://doc.zonemaster.net/v2025.2/using/backend/Using-Zonemaster-Backend-Docker.md> (#1441)
- Adds Dockerfile and Docker image for Backend. See Zonemaster-Backend and [Using Docker Backend] document (#1441)

@tgreenx tgreenx merged commit f5cd0ef into zonemaster:develop Dec 18, 2025
@matsduf matsduf deleted the preparation-release-v2025.2 branch December 18, 2025 15:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Documentation Area: Documentation only. P-High Priority: Issue to be solved before other RC-None Release category: Not to be included in Changes file.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants