Skip to content

[WIP] 8.1.0 MTA RNs#299

Merged
mpershina merged 18 commits intomainfrom
release-notes_8.1.0
Mar 24, 2026
Merged

[WIP] 8.1.0 MTA RNs#299
mpershina merged 18 commits intomainfrom
release-notes_8.1.0

Conversation

@mpershina
Copy link
Copy Markdown
Collaborator

@mpershina mpershina commented Feb 4, 2026

Document attributes PR: #300
Release notes preview: https://mpershina.github.io/Previews/MTA/8.1.0_RNs.html

Summary by CodeRabbit

  • Documentation
    • Added comprehensive 8.1.0 release notes and a new 8.0 assembly; reordered assemblies to prioritize 8.1.0 while reintroducing 8.0 content.
    • Added separate reference pages for fixed issues, known issues, and new features for 8.1.0.
    • Documented major enhancements: centralized configuration, profiles/migrators, C#/.NET analysis provider, and VS Code extension pack.
    • Noted known issue: UI does not trigger dependency rules for Gradle apps (CLI unaffected).

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Feb 13, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds new MTA 8.1.0 release-notes assembly and three 8.1.0 topic pages, introduces an MTA 8.0 assembly, updates the master release-notes index to prioritize 8.1.0 and re-add 8.0, and makes small wording/format edits in several 8.0 topic files.

Changes

Cohort / File(s) Summary
Assemblies
assemblies/release-notes/assembly_mta-8-1-0.adoc, assemblies/release-notes/assembly_mta-8-0.adoc
New AsciiDoc assembly files added for MTA 8.1.0 and MTA 8.0: metadata, context IDs, abstracts, and includes referencing topic fragments with leveloffset adjustments.
8.1.0 Topics
docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc, docs/topics/release-notes-topics/ref_known-issues-8-1-0.adoc, docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc
New reference topics for 8.1.0: features/enhancements, known issues (includes a Gradle UI dependency-analysis issue and MTA-6211), and fixed issues; include metadata and abstracts.
8.0 Topic edits
docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-0.adoc, docs/topics/release-notes-topics/ref_removed-features-8-0.adoc, docs/topics/release-notes-topics/ref_tech-previews-8-0.adoc
Minor textual edits: explicit "8.0.0" in abstracts, clarified removal of XML rules with issue reference (MTA-5357), and a small formatting blank-line insertion.
Master index
docs/release-notes/master.adoc
Updated include ordering to reference assembly_mta-8-1-0 first, reinserted the 8.0 assembly, removed an obsolete placeholder block, and adjusted ordering/comments.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested reviewers

  • Pkylas007

Poem

🐇 I hopped through notes both old and new,
I stacked 8.1 first and nudged 8.0 too,
Abstracts in order, topics set right,
Known quirks flagged, fixes in sight,
A tiny carrot for the docs tonight 🥕

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title uses the acronym 'RNs' which is not immediately clear to someone unfamiliar with the project context; it lacks full clarity about the scope and purpose of the changes. Consider expanding the title to be more explicit, such as 'Add release notes for MTA 8.1.0' or 'Update release notes assemblies and topics for 8.1.0 release' to improve clarity for teammates scanning the project history.
✅ Passed checks (2 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch release-notes_8.1.0

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 and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc`:
- Line 5: The document ID string "fixes-issues-8-1-0_{context}" is a typo and
should match the heading "Fixed issues"; update the ID to
"fixed-issues-8-1-0_{context}" so the identifier and heading are consistent
(locate the ID token "fixes-issues-8-1-0_{context}" and replace "fixes-issues"
with "fixed-issues").
🧹 Nitpick comments (1)
docs/topics/release-notes-topics/ref_removed-features-8-0.adoc (1)

14-14: Consider using explicit version for consistency.

Line 14 uses the placeholder {ProductVersion} while the abstract at line 9 uses the explicit version "8.0.0". For consistency within the document, consider using "8.0.0" explicitly here as well.

📝 Suggested change for consistency
-In {ProductFullName} {ProductVersion}, XML rules are removed and are no longer supported both in the {ProductShortName} user interface (UI) and command-line interface (CLI).
+In {ProductFullName} 8.0.0, XML rules are removed and are no longer supported both in the {ProductShortName} user interface (UI) and command-line interface (CLI).

Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Co-authored-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@redhat.com>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

♻️ Duplicate comments (1)
docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc (1)

5-5: Document ID typo is now correctly resolved.

The ID fixed-issues-8-1-0_{context} now matches the = Fixed issues heading. No further action needed here.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc` at line 5,
Update the AsciiDoc anchor so it exactly matches the heading by replacing the
placeholder id "fixed-issues-8-1-0_{context}" with the canonical id
"fixed-issues-8-1-0" (so it aligns with the "= Fixed issues" heading); locate
the id attribute in the
docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc file (the id string
"fixed-issues-8-1-0_{context}") and remove the "{context}" suffix so the anchor
and heading match.
🧹 Nitpick comments (1)
docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc (1)

8-9: Stub file — ensure fixed-issue entries are added before merging.

The abstract says "provides the following fixed issues," but the file contains no actual issue entries. This is expected for a [WIP] PR, but the content must be populated (e.g., a table or list of JIRA/BZ references with descriptions) before this file is merged to main.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc` around lines 8
- 9, The abstract block marked with [role="_abstract"] currently claims
"provides the following fixed issues" but contains no entries; populate this
release-notes abstract by adding the fixed-issue entries (each with a JIRA/BZ
identifier and a short description) either as a bulleted list or a table under
that [role="_abstract"] paragraph, ensuring each entry references the ticket ID
and a one-line summary and removing the WIP stub before merging.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc`:
- Line 9: Replace the phrase "other problems that have a significant impact"
with "other issues that have a significant impact" in the sentence that reads
"{ProductFirstRef} ({ProductShortName}) version 8.1.0 provides the following
fixed issues and other problems that have a significant impact." so the wording
is consistent with the section title and standard release-note style.

---

Duplicate comments:
In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc`:
- Line 5: Update the AsciiDoc anchor so it exactly matches the heading by
replacing the placeholder id "fixed-issues-8-1-0_{context}" with the canonical
id "fixed-issues-8-1-0" (so it aligns with the "= Fixed issues" heading); locate
the id attribute in the
docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc file (the id string
"fixed-issues-8-1-0_{context}") and remove the "{context}" suffix so the anchor
and heading match.

---

Nitpick comments:
In `@docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc`:
- Around line 8-9: The abstract block marked with [role="_abstract"] currently
claims "provides the following fixed issues" but contains no entries; populate
this release-notes abstract by adding the fixed-issue entries (each with a
JIRA/BZ identifier and a short description) either as a bulleted list or a table
under that [role="_abstract"] paragraph, ensuring each entry references the
ticket ID and a one-line summary and removing the WIP stub before merging.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2efa216 and 34ee9ec.

📒 Files selected for processing (2)
  • docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc
  • docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc

Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc`:
- Line 51: Remove or replace the unfinished line "(Placeholder) Support for LLM
Proxying with MTA": either delete it entirely or replace it with a properly
formatted AsciiDoc entry that includes a clear heading, a brief descriptive body
of the feature, and a Jira reference/issue ID; ensure the new content follows
the surrounding release-notes structure (heading + paragraph or bullet points)
so it does not render verbatim in the published output.
- Line 30: The inline code span around `location,` incorrectly includes the
comma; update the text so the comma is outside the backticks (e.g., use
`location`, not `location,`) in the sentence referencing the csharp provider and
the rule fields (`pattern`, `location`, and `file_path`) used for
{ProductShortName} analysis.
- Line 21: The final clause mixes noun phrases with a prepositional phrase ("in
the UI, CLI, and by using the Visual Studio Code plugin"); make the list
parallel by using the same grammatical form for all items—e.g., replace that
clause in the sentence starting "Profiles contain analysis configuration..."
with a parallel phrase such as "via the UI, CLI, and Visual Studio Code plugin"
or "in the UI, in the CLI, and in the Visual Studio Code plugin" so all three
items match.
- Line 47: Remove the contradictory sentence "You can also use this extension
when you want to analyze a project in a specific programming language" and
eliminate the duplicate "You can also" by changing "Alternatively, you can also
download the {ProductShortName} Core extension..." to "Alternatively, download
the {ProductShortName} Core extension..." so the paragraph reads: the extension
pack description followed by the single-language alternative; edit the sentence
containing "You can also use this extension..." and the sentence starting
"Alternatively, you can also" accordingly.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 34ee9ec and 80e29aa.

📒 Files selected for processing (1)
  • docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc

Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

♻️ Duplicate comments (3)
docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc (3)

51-51: ⚠️ Potential issue | 🟠 Major

Remove or replace unfinished placeholder content before merge.

Line 51 still contains draft text: (Placeholder) Support for LLM Proxying with MTA. This will render as-is in published release notes and should be replaced with final structured content (or removed).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc`
at line 51, Replace or remove the unfinished placeholder text "(Placeholder)
Support for LLM Proxying with MTA" in the release notes entry so it no longer
renders as draft; either substitute it with the final structured release-note
content (title, short description, impact, and any upgrade notes) for the
"Support for LLM Proxying with MTA" item or delete that line entirely if the
feature won't be included in this release.

21-21: ⚠️ Potential issue | 🟡 Minor

Fix non-parallel phrasing in the tool list sentence.

Line 21 mixes forms in one list ("in the UI, CLI, and by using..."). Make all three items parallel for readability.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc`
at line 21, The sentence "Migrators can sync with the {ProductShortName} Hub to
download available configuration bundles and use them to run an analysis in the
UI, CLI, and by using the Visual Studio Code plugin." uses mixed phrasing; make
the three tools parallel by changing the final part to match the preposition
style (e.g., "in the UI, in the CLI, and in the Visual Studio Code plugin" or
better "via the UI, CLI, and Visual Studio Code plugin") so the list items are
grammatically consistent; update that sentence in the document so all three
items use the same form (prefer "via the UI, CLI, and Visual Studio Code
plugin").

30-30: ⚠️ Potential issue | 🟡 Minor

Move the comma outside the inline code span.

At Line 30, `location,` should be `location` with the comma outside backticks.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc`
at line 30, The inline code span contains a trailing comma inside the backticks
(`location,`) — move the comma outside the code span so the identifier remains
`location` and the sentence punctuation follows it; update the text fragment
referencing `pattern`, `location,` and `file_path` to read `pattern`,
`location`, and `file_path` (i.e., remove the comma from inside the backticks
and place it after the code span).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In
`@docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc`:
- Line 51: Replace or remove the unfinished placeholder text "(Placeholder)
Support for LLM Proxying with MTA" in the release notes entry so it no longer
renders as draft; either substitute it with the final structured release-note
content (title, short description, impact, and any upgrade notes) for the
"Support for LLM Proxying with MTA" item or delete that line entirely if the
feature won't be included in this release.
- Line 21: The sentence "Migrators can sync with the {ProductShortName} Hub to
download available configuration bundles and use them to run an analysis in the
UI, CLI, and by using the Visual Studio Code plugin." uses mixed phrasing; make
the three tools parallel by changing the final part to match the preposition
style (e.g., "in the UI, in the CLI, and in the Visual Studio Code plugin" or
better "via the UI, CLI, and Visual Studio Code plugin") so the list items are
grammatically consistent; update that sentence in the document so all three
items use the same form (prefer "via the UI, CLI, and Visual Studio Code
plugin").
- Line 30: The inline code span contains a trailing comma inside the backticks
(`location,`) — move the comma outside the code span so the identifier remains
`location` and the sentence punctuation follows it; update the text fragment
referencing `pattern`, `location,` and `file_path` to read `pattern`,
`location`, and `file_path` (i.e., remove the comma from inside the backticks
and place it after the code span).

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 80e29aa and c6f94c2.

📒 Files selected for processing (2)
  • docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc
  • docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc

Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Copy link
Copy Markdown

@shawn-hurley shawn-hurley left a comment

Choose a reason for hiding this comment

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

I think for the most part this looks good, my only concern is that some of the language providers are not fully GA in the product yet but are tech-preview/dev-preview.

Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
mpershina and others added 2 commits February 26, 2026 14:44
Co-authored-by: Maayan Hadasi <60384172+mguetta1@users.noreply.github.com>
Comment thread docs/topics/release-notes-topics/ref_tech-preview-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_tech-preview-8-1-0.adoc Outdated
Comment on lines +54 to +57
* C#
* .NET
+
:FeatureName: Analyzing applications written in .NET
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.

I am not sure both C# and .NET extensions exist.
@savitharaghunathan @hhpatel14 could you please take a look?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

No, it's just one extension. I'd probably just call it C#

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.

Thanks! Then I shall remove .NET from the docs (we have a couple of mentions within the docset)

Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc
Comment thread docs/topics/release-notes-topics/ref_dev-preview-8-1-0.adoc
Comment thread docs/topics/release-notes-topics/ref_dev-preview-8-1-0.adoc
Copy link
Copy Markdown
Contributor

@dymurray dymurray left a comment

Choose a reason for hiding this comment

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

One request, aside from that LGTM

Comment thread docs/topics/release-notes-topics/ref_dev-preview-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_fixed-issues-8-1-0.adoc Outdated
mpershina and others added 2 commits March 24, 2026 13:18
Co-authored-by: Andy Arnold <anarnold@redhat.com>
Co-authored-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@redhat.com>
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_dev-preview-8-1-0.adoc Outdated
Comment thread docs/topics/release-notes-topics/ref_dev-preview-8-1-0.adoc Outdated
Co-authored-by: Andy Arnold <anarnold@redhat.com>
Comment thread docs/topics/release-notes-topics/ref_new-features-and-enhancements-8-1-0.adoc Outdated
@mpershina mpershina merged commit 2553287 into main Mar 24, 2026
1 of 2 checks passed
@coderabbitai coderabbitai Bot mentioned this pull request Mar 25, 2026
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.

10 participants