Skip to content

docs: add changelog entries for PRs #579-#590#614

Open
sebbader-sap wants to merge 1 commit into
IDTA-01002-3-2_workingfrom
changelog/pr579-582-v3.2
Open

docs: add changelog entries for PRs #579-#590#614
sebbader-sap wants to merge 1 commit into
IDTA-01002-3-2_workingfrom
changelog/pr579-582-v3.2

Conversation

@sebbader-sap

Copy link
Copy Markdown
Contributor

Changelog Entries for V3.2 PRs

This PR adds changelog entries for PRs #579-#590 targeting the V3.2 release.

Bugfixes (PRs #579-#582)

Documentation Enhancements (PRs #583-#590)

All entries follow the format established in previous changelog entries, focusing on clear descriptions without GitHub issue links (as these are review changes).

Related

Comment thread documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc Dismissed
Comment thread documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc Dismissed
@sebbader-sap sebbader-sap added this to the 3.2 milestone May 20, 2026

@aaronzi aaronzi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Several changelog entries describe PRs that are still open as of June 5, 2026: #579, #580, #581, #582, #586, and #588. If #614 is merged before those land, the changelog will advertise changes that are not yet in the target branch. Please make sure to merge #614 after those PRs.

All other remarks are inline.

Backports #610, #612, and #613 otherwise match their corresponding original PRs closely, with the expected extra V3.1.3 changelog line.

Minor Changes:

* fix: Harmonized `SecurityQueryFilter` between API and Security specifications and added missing `FILTERLIST` construct to the BNF grammar and JSON Schema.
* fix: Aligned `idShort` pattern in BNF grammar and JSON Schema with Metamodel Constraint AASd-002 to correctly enforce minimum two characters and prevent trailing hyphens.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The referenced PR #580 also changes Part2-API-Schemas/openapi.yaml, and its own PR body claims pages/schema.adoc is touched, though the actual #580 diff does not include that file. The related backport #611 does include both OpenAPI and schema.adoc. Please make this changelog entry explicit about the OpenAPI schema update, and double-check whether #580 is missing the generated schema.adoc update.

* docs: Added normative Query Evaluation Semantics clause to standardize query behavior across implementations, including error handling, field resolution, and list-valued matching.
* docs: Added normative Operation-to-RIGHT mapping table documenting the correspondence between HTTP/REST API operations and IDTA-01004 rightsEnum values.
* docs: Added cross-spec terminology matrix reference to align Metamodel classes, API path segments, and Query/Access-Rule prefixes across specifications.
* docs: Added cross-specification alignment matrix to document API compatibility with IDTA-01001 (Metamodel v3.2) and IDTA-01004 (Security v3.1).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

PR #588’s actual diff replaces the old dependency/version section with a broader alignment matrix covering IDTA-01001, IDTA-01003-a, IDTA-01003-b, IDTA-01004, and IDTA-01005, including changing IDTA-01005 from v3.1 to v3.2. This entry only mentions IDTA-01001 and IDTA-01004, so it undersells part of the actual changelog impact. Please mention the broader companion-spec alignment, or at least include the IDTA-01005 v3.2 alignment.

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.

3 participants