adds avaiable language for app generate

[paulohtb6]

Description

Resolves https://redpandadata.atlassian.net/browse/DOC-1777
Review deadline:

Page previews

Checks

• New feature
• Content gap
• Support Follow-up
• Small fix (typos, links, copyedits, etc)

[netlify]

✅ Deploy Preview for redpanda-docs-preview ready!

Name	Link
🔨 Latest commit	db59118
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-docs-preview/deploys/69015cfeca17010007c8008b
😎 Deploy Preview	https://deploy-preview-1426--redpanda-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

📝 Walkthrough

Walkthrough

This change updates the AsciiDoc documentation for the rpk-generate-app command. The modifications include adding explicit language availability information ("Available language: go.") to the --language flag descriptions and introducing multiple example blocks that demonstrate different usage scenarios: interactive mode, specifying a language, creating a new SASL user, and disabling user creation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~5–10 minutes

• Documentation file update with straightforward additions to help text
• New example blocks follow standard usage documentation patterns
• No code logic, dependencies, or structural changes to review

Pre-merge checks and finishing touches

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.
Description Check	⚠️ Warning	The pull request description follows the required template structure and includes the JIRA ticket reference (DOC-1777) properly filled in. However, critical sections are incomplete. The "Page previews" section contains only placeholder comments without any actual preview links provided, which is particularly important for documentation changes that modify user-facing content. Additionally, none of the classification checkboxes under "Checks" are marked, making it unclear what type of change this represents. While the review deadline field is blank (matching the template), the missing page previews and unchecked classification checkboxes represent key information gaps for a documentation pull request.	The author should add an actual Netlify preview link to the "Page previews" section following the format provided in the template comments (deploy-preview---redpanda-docs-preview.netlify.app/). Additionally, the author must check at least one checkbox under "Checks" to indicate the type of change—based on the summary, this appears to be either a "Content gap" or "Small fix" that adds examples and clarifies language availability. The review deadline can remain blank if not applicable, but these two items need to be completed before merging.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The pull request title "adds avaiable language for app generate" is directly related to the main change in the pull request, which updates the documentation to include explicit information about the available language (Go) for the rpk-generate-app command. The title clearly summarizes the primary focus of the changeset and is specific enough that a teammate reviewing the history would understand what was modified. However, there is a spelling error: "avaiable" should be spelled "available."

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch go-generate-app

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (3)

modules/reference/pages/rpk/rpk-generate/rpk-generate-app.adoc (3)

19-19: Improve phrasing for clarity.

The sentence fragment "Available language: go." reads awkwardly after "There is no default." Consider rephrasing to flow more naturally within the full sentence.

-The `--language` flag lets you specify the language. There is no default. Available language: `go`.
+The `--language` flag lets you specify the language; currently, only `go` is supported. There is no default.

Alternatively:

-The `--language` flag lets you specify the language. There is no default. Available language: `go`.
+The `--language` flag lets you specify the language. Currently, only `go` is supported.

---

75-76: Improve phrasing for clarity in flags description.

The description trailing into "Available language: go." reads awkwardly. Consider integrating the language constraint more naturally into the sentence.

 |-l, --language |string |The language you want the code sample to be
-generated with. Available language: `go`.
+generated with (currently only `go` is supported).

---

21-21: Pre-existing flag name inconsistency (outside scope of this PR).

Unrelated to your changes, but worth noting for a future follow-up: Line 21 references --new-sasl--user (appears to be a typo with double dash), the examples on line 50 show --new-sasl-user, but the flags table defines the actual flag as --new-sasl-credentials on line 78. These should be reconciled to avoid user confusion.

Also applies to: 78-78

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Jira integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 1acb648 and db59118.

📒 Files selected for processing (1)

• modules/reference/pages/rpk/rpk-generate/rpk-generate-app.adoc (2 hunks)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)

• GitHub Check: Redirect rules - redpanda-docs-preview
• GitHub Check: Header rules - redpanda-docs-preview
• GitHub Check: Pages changed - redpanda-docs-preview

🔇 Additional comments (1)

modules/reference/pages/rpk/rpk-generate/rpk-generate-app.adoc (1)

32-58: Verify example blocks in AI summary.

The AI-generated summary mentions "Added user-facing example blocks demonstrating various ways to generate an app," but these lines are not marked with ~ in the annotated code. Please confirm whether these examples were pre-existing or are part of this PR. If they were newly added, they should be marked as changed in the annotation.

[micheleRP]

I also updated this here in redpanda-data/cloud-docs#432

[kbatuigas]

Only thing to note is for future-proofing, it would be better to say "Available languages:" even if the list currently only contains one item. But not sure how soon we'll see more options on this list. I'll approve but feel free to change it to "languages" if you like.