Skip to content

MTA-6757 Formatting Fixes#353

Merged
Pkylas007 merged 2 commits intomainfrom
mta-6757-formatting-fixes
Apr 14, 2026
Merged

MTA-6757 Formatting Fixes#353
Pkylas007 merged 2 commits intomainfrom
mta-6757-formatting-fixes

Conversation

@Pkylas007
Copy link
Copy Markdown
Collaborator

@Pkylas007 Pkylas007 commented Apr 14, 2026

JIRA

Version

  • 8.2.0

Previews

Summary by CodeRabbit

Summary by CodeRabbit

  • Documentation
    • Removed a formatting artifact in CLI configuration reference for clearer option descriptions.
    • Improved inline code formatting in release notes to clarify a binary analysis term.
    • Standardized provider naming and related formatting in provider development documentation.

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 14, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a4676c74-e4d9-4bdf-b658-bcd760cfa42a

📥 Commits

Reviewing files that changed from the base of the PR and between fc80173 and 0fadd44.

📒 Files selected for processing (1)
  • docs/topics/rules-development/yaml-dotnet-provider.adoc
✅ Files skipped from review due to trivial changes (1)
  • docs/topics/rules-development/yaml-dotnet-provider.adoc

📝 Walkthrough

Walkthrough

Three documentation files receive minor editorial updates: removal of an extraneous AsciiDoc list separator in CLI config docs, inline code formatting added for source+dependency in release notes, and provider name occurrences changed from C# to csharp with minor punctuation/whitespace adjustments.

Changes

Cohort / File(s) Summary
CLI Documentation
docs/topics/mta-cli/ref_mta-cli-config-flags.adoc
Removed an extraneous AsciiDoc list separator marker (+) from the login option description to eliminate a formatting artifact.
Release Notes
docs/topics/release-notes-topics/ref_fixed-issues-8-0-1.adoc
Wrapped source+dependency in inline code formatting to correctly display the term in release notes.
Provider Docs
docs/topics/rules-development/yaml-dotnet-provider.adoc
Standardized provider naming by replacing occurrences of C# with csharp, and adjusted surrounding punctuation/blank lines for consistency; YAML example remains csharp.referenced.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Suggested reviewers

  • mguetta1
  • shawn-hurley
  • anarnold97

Poem

🐇 I hopped through docs at break of day,
Found stray plus signs that lost their way,
Backticks hugged terms with gentle art,
C# now whispers as "csharp" — smart,
Hooray, the pages gleam, hooray! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'MTA-6757 Formatting Fixes' accurately summarizes the main changes: removing formatting artifacts, fixing code formatting, and standardizing provider naming across documentation files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ 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 mta-6757-formatting-fixes

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.

🧹 Nitpick comments (2)
docs/topics/rules-development/yaml-dotnet-provider.adoc (2)

7-7: Keep provider naming consistent between heading and body.

The heading uses Csharp while the body consistently uses `csharp`. Consider aligning the heading to the same canonical form to avoid drift in terminology.

Also applies to: 10-10

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

In `@docs/topics/rules-development/yaml-dotnet-provider.adoc` at line 7, The
document heading "Csharp provider" is inconsistent with the body which uses
`csharp`; update the heading text to match the canonical form used in the body
(change "Csharp" to "csharp") and scan for the other occurrence noted (line
range 10-10) to apply the same change so both headings use the same "csharp"
naming.

12-12: Expand acronym on first mention (gRPC).

Please introduce the expanded term before the abbreviation on first use (for example, ... uses <full term> (gRPC) ...) to match repo documentation style.

Based on learnings: In the documentation, when introducing an acronym/abbreviation, write the full expanded name first and then the abbreviation in parentheses.

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

In `@docs/topics/rules-development/yaml-dotnet-provider.adoc` at line 12, Update
the sentence in the docs where the "csharp" provider is described so the acronym
is expanded on first use: replace the bare "gRPC" with the full term followed by
the abbreviation (e.g., "Google Remote Procedure Call (gRPC)") in the sentence
that begins "The `csharp` provider uses a gRPC interface..."; ensure the rest of
the sentence (mentions of `source-only`, tree-sitter, and stack graph) remains
unchanged.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/topics/rules-development/yaml-dotnet-provider.adoc`:
- Line 7: The document heading "Csharp provider" is inconsistent with the body
which uses `csharp`; update the heading text to match the canonical form used in
the body (change "Csharp" to "csharp") and scan for the other occurrence noted
(line range 10-10) to apply the same change so both headings use the same
"csharp" naming.
- Line 12: Update the sentence in the docs where the "csharp" provider is
described so the acronym is expanded on first use: replace the bare "gRPC" with
the full term followed by the abbreviation (e.g., "Google Remote Procedure Call
(gRPC)") in the sentence that begins "The `csharp` provider uses a gRPC
interface..."; ensure the rest of the sentence (mentions of `source-only`,
tree-sitter, and stack graph) remains unchanged.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 977b07a1-1a67-4818-88ef-c09011a6b1d9

📥 Commits

Reviewing files that changed from the base of the PR and between f85fa32 and fc80173.

📒 Files selected for processing (3)
  • docs/topics/mta-cli/ref_mta-cli-config-flags.adoc
  • docs/topics/release-notes-topics/ref_fixed-issues-8-0-1.adoc
  • docs/topics/rules-development/yaml-dotnet-provider.adoc
💤 Files with no reviewable changes (1)
  • docs/topics/mta-cli/ref_mta-cli-config-flags.adoc

@Pkylas007
Copy link
Copy Markdown
Collaborator Author

Pkylas007 commented Apr 14, 2026

Looking for a uniform way of handling gRPC expansion in Red Hat docs: It cannot be Google Remote Procedure Call because it's not owned by Google these days.

Comment thread docs/topics/rules-development/yaml-dotnet-provider.adoc Outdated
Copy link
Copy Markdown
Collaborator

@mpershina mpershina left a comment

Choose a reason for hiding this comment

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

A small change is needed. Otherwise, LGTM!

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 merged commit 5f2d9a0 into main Apr 14, 2026
2 checks passed
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