Skip to content

[MTA] [RN] Release notes for 8.2.0#370

Open
mpershina wants to merge 3 commits into
mainfrom
8.2.0-RNs
Open

[MTA] [RN] Release notes for 8.2.0#370
mpershina wants to merge 3 commits into
mainfrom
8.2.0-RNs

Conversation

@mpershina

@mpershina mpershina commented Jun 12, 2026

Copy link
Copy Markdown
Collaborator

TRACKERS

RNs: https://redhat.atlassian.net/browse/MTA-6490
Attributes:

Summary by CodeRabbit

  • Documentation
    • Added release notes for version 8.2.0, including dedicated sections for New features and enhancements, Known issues, and Fixed issues.
    • Updated the main release-notes index to include the new 8.2.0 assembly between existing versions, making the latest documentation easier to find and navigate.

@mpershina mpershina self-assigned this Jun 12, 2026
@coderabbitai

coderabbitai Bot commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@mpershina, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 58 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e67f4991-57d0-4abe-88ac-d549ff493129

📥 Commits

Reviewing files that changed from the base of the PR and between a3c0ec8 and 4a4224f.

📒 Files selected for processing (1)
  • assemblies/release-notes/assembly_mta-8-2-0.adoc
📝 Walkthrough

Walkthrough

This pull request adds the documentation structure for MTA version 8.2.0 release notes. Three topic files and one assembly file are created, and the master release-notes document is updated to include the new assembly.

Changes

MTA 8.2.0 Release Notes Structure

Layer / File(s) Summary
Release Notes Topics for 8.2.0
docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc, docs/topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc, docs/topics/release-notes-topics/ref_known-issues-8-2-0.adoc
Three new topic files are added with document metadata, ID anchors, titles, and abstract text. The new-features file includes placeholder sections for enhancement references, the fixed-issues file provides introductory content, and the known-issues file adds placeholder issue context.
Release Notes Assembly and Integration
assemblies/release-notes/assembly_mta-8-2-0.adoc, docs/release-notes/master.adoc
A new assembly file sets version-specific metadata and context handling, includes the release-notes topics, and provides the 8.2.0 abstract. The assembly is then included in the master release-notes document between the existing version entries.

Estimated code review effort: 1 (Trivial) | ~8 minutes

Possibly related PRs

Suggested reviewers: anarnold97, dymurray, rromannissen

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: adding release notes for version 8.2.0.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 8.2.0-RNs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@assemblies/release-notes/assembly_mta-8-2-0.adoc`:
- Around line 17-18: The abstract currently promises sections not present;
update the role="_abstract" text in assembly_mta-8-2-0.adoc to only list the
sections actually included (new-features and fixed-issues). Edit the line that
begins with [role="_abstract"] / the following sentence so it references only
"{ProductFullName} 8.2.0 new features and fixed issues" (remove references to
Technology Preview, removed features, and known issues) to match the assembly
contents.
- Line 13: Replace the hard-coded heading "= mta 8.2.0" with the product
attribute used elsewhere so the title reads "= {ProductShortName} 8.2.0"; update
the top-level assembly heading in assembly_mta-8-2-0.adoc to use
{ProductShortName} following the same pattern as the 8.1.0 assembly to keep
branding consistent.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 06247b99-210f-4560-8d9c-a57a1094e23b

📥 Commits

Reviewing files that changed from the base of the PR and between 0f51832 and c39a4ef.

📒 Files selected for processing (4)
  • assemblies/release-notes/assembly_mta-8-2-0.adoc
  • docs/release-notes/master.adoc
  • docs/topics/release-notes-topics/ref_fixed-issues-8-2-0.adoc
  • docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-2-0.adoc

Comment thread assemblies/release-notes/assembly_mta-8-2-0.adoc Outdated
Comment on lines +17 to +18
[role="_abstract"]
Review new features, enhancements, Technology Preview features, removed features, fixed issues, and known issues in {ProductFullName} 8.2.0.

@coderabbitai coderabbitai Bot Jun 12, 2026

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.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Trim the abstract to the included sections.

This abstract still advertises Technology Preview, removed features, and known-issues content, but this assembly only includes the new-features and fixed-issues topics. Either add the missing includes or narrow the abstract so the page doesn't promise sections that aren't present.

♻️ Proposed fix
-[role="_abstract"]
-Review new features, enhancements, Technology Preview features, removed features, fixed issues, and known issues in {ProductFullName} 8.2.0.
+[role="_abstract"]
+Review new features, enhancements, and fixed issues in {ProductFullName} 8.2.0.

Based on the existing 8.1.0 assembly pattern, the abstract should mirror the sections that are actually included.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
[role="_abstract"]
Review new features, enhancements, Technology Preview features, removed features, fixed issues, and known issues in {ProductFullName} 8.2.0.
[role="_abstract"]
Review new features, enhancements, and fixed issues in {ProductFullName} 8.2.0.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@assemblies/release-notes/assembly_mta-8-2-0.adoc` around lines 17 - 18, The
abstract currently promises sections not present; update the role="_abstract"
text in assembly_mta-8-2-0.adoc to only list the sections actually included
(new-features and fixed-issues). Edit the line that begins with
[role="_abstract"] / the following sentence so it references only
"{ProductFullName} 8.2.0 new features and fixed issues" (remove references to
Technology Preview, removed features, and known issues) to match the assembly
contents.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

AI: @mpershina, adjust when the RNs list is confirmed

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.

@mpershina, sounds good — I'll leave this as-is for now. Feel free to update the abstract once the final release notes list for 8.2.0 is confirmed.


🧠 Learnings used
Learnt from: Pkylas007
Repo: migtools/mta-documentation PR: 329
File: docs/topics/rules-development/yaml-provider-conditions.adoc:457-457
Timestamp: 2026-03-18T08:59:21.462Z
Learning: In migtools/mta-documentation, do not flag or review cross-reference (xref) anchor ID mismatches or broken xrefs in AsciiDoc (.adoc) files. Maintainers have explicitly requested ignoring xref issues for this repository. Apply this guidance to all .adoc files in the project (pattern: **/*.adoc); do not raise xref-related review comments for these files unless the directive is explicitly lifted.

Learnt from: Pkylas007
Repo: migtools/mta-documentation PR: 326
File: assemblies/ui-guide/assembly_centralized-configurations-analysis.adoc:20-20
Timestamp: 2026-03-30T15:14:19.266Z
Learning: In this repository’s AsciiDoc (.adoc) files, follow Red Hat documentation style for the specific construct: it’s acceptable to use a sentence fragment that starts with “For example, …” as a standalone sentence when it follows a preceding complete statement. Do not flag this as an AsciiDoc grammar or readability issue.

Learnt from: mpershina
Repo: migtools/mta-documentation PR: 339
File: docs/topics/vscode/proc_vscode-analyzing-application.adoc:6-6
Timestamp: 2026-04-09T08:49:54.549Z
Learning: In the documentation, when introducing an acronym/abbreviation, write the full expanded name first and then the abbreviation in parentheses. Example: "Remote Procedure Call (RPC)". Do not use the reverse order (e.g., "RPC (Remote Procedure Call)") when first defining the acronym.

Comment on lines +11 to +12
// placeholder for https://redhat.atlassian.net/browse/MTA-7103
// SME inputs: When running kubectl apply, if the namespace and its resources already exist on the target cluster, they will be silently overwritten. Since this is an issue with kubectl apply, it falls outside the scope of Crane.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

@istein1, could you please review this KI? Thanks a lot!

Suggested change
// placeholder for https://redhat.atlassian.net/browse/MTA-7103
// SME inputs: When running kubectl apply, if the namespace and its resources already exist on the target cluster, they will be silently overwritten. Since this is an issue with kubectl apply, it falls outside the scope of Crane.
Deploying mta-ops manifests overwrites existing target resources without warning::
+
The `mta-ops` pipeline lacks a pre-flight check to verify if a target namespace already exists. During deployment, the `kubectl apply` command silently overwrites existing resources by default without any warning. As a consequence, you might accidentally overwrite existing workloads on the target cluster.
+
To work around this problem, manually verify that the target namespace lacks conflicting resources before deployment.
+
link:https://redhat.atlassian.net/browse/MTA-7103[MTA-7103]

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.

1 participant