Skip to content

LCORE-1457 Add SUPPORT.md, which appears with info when opening a GH issue#1315

Open
max-svistunov wants to merge 1 commit intolightspeed-core:mainfrom
max-svistunov:lcore-1457-contrib-guide-bug-reporting
Open

LCORE-1457 Add SUPPORT.md, which appears with info when opening a GH issue#1315
max-svistunov wants to merge 1 commit intolightspeed-core:mainfrom
max-svistunov:lcore-1457-contrib-guide-bug-reporting

Conversation

@max-svistunov
Copy link
Contributor

@max-svistunov max-svistunov commented Mar 12, 2026

Description

Add SUPPORT.md with info on reporting bugs.

Type of change

  • Refactor
  • New feature
  • Bug fix
  • CVE fix
  • Optimization
  • Documentation Update
  • Configuration Update
  • Bump-up service version
  • Bump-up dependent library
  • Bump-up library or tool used for development (does not change the final image)
  • CI configuration change
  • Konflux configuration change
  • Unit tests improvement
  • Integration tests improvement
  • End to end tests improvement
  • Benchmarks improvement

Tools used to create PR

Identify any AI code assistants used in this PR (for transparency and review context)

  • Assisted-by: Claude Opus 4.6
  • Generated by: Claude Opus 4.6

Related Tickets & Documents

  • Related Issue # LCORE-1457
  • Closes # LCORE-1457

Summary by CodeRabbit

  • Documentation
    • Updated bug report template to clarify Lightspeed Stack version information.
    • Added support guide documenting bug reporting procedures with separate workflows for external contributors (GitHub) and Red Hat contributors (Jira), including escalation paths and required report details such as reproduction steps and expected vs. actual behavior.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 12, 2026

Walkthrough

Updated the bug report template heading to "Lightspeed Stack version" and added a new SUPPORT.md file documenting bug reporting procedures for both external contributors via GitHub issues and Red Hat contributors via Jira.

Changes

Cohort / File(s) Summary
Documentation & Templates
.github/ISSUE_TEMPLATE/bug_report.md, SUPPORT.md
Updated issue template heading and added new support documentation detailing bug reporting procedures, required information for bug reports, and escalation paths for external and internal contributors.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 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 clearly and specifically summarizes the main change: adding a SUPPORT.md file for bug reporting information that appears when opening GitHub issues.
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
  • Post copyable unit tests in a comment
📝 Coding Plan for PR comments
  • Generate coding plan

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
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

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

Inline comments:
In `@SUPPORT.md`:
- Line 3: Confirm with `@ptisnovs` whether they should be tagged for urgent issues
and then replace the HTML FIXME comment in the "For urgent issues..." line:
either explicitly instruct "For urgent issues, tag `@ptisnovs` in the issue" if
they agree, or update the guidance to an alternative escalation path (e.g., "For
urgent issues, open an issue, add the 'urgent' label, and notify the maintainers
via the org Slack `#support` or mention the `@maintainers` team") so the FIXME is
removed and the urgent-escalation step is fully specified.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 76c29a31-c330-498d-8668-476feb8fee45

📥 Commits

Reviewing files that changed from the base of the PR and between 69b9368 and 93775fb.

📒 Files selected for processing (2)
  • .github/ISSUE_TEMPLATE/bug_report.md
  • SUPPORT.md

@@ -0,0 +1,6 @@
# Reporting bugs

* **External contributors**: Open a [GitHub Issue](https://github.com/lightspeed-core/lightspeed-stack/issues/new?template=bug_report.md) using the bug report template. For urgent issues, tag <!-- FIXME: is it fine @ptisnovs to tag you like this? --> in the issue.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Resolve the FIXME comment and complete the urgent issue guidance.

Line 3 contains an unresolved FIXME comment asking for confirmation about tagging someone, and the urgent issue escalation path for external contributors is incomplete. The text reads "For urgent issues, tag in the issue" without specifying who or what to tag.

Please resolve the following before merging:

  1. Confirm with @ptisnovs (or the appropriate person/team) whether they should be tagged for urgent issues
  2. Complete the guidance by either:
    • Specifying the person/team to tag (e.g., "tag @ptisnovs in the issue"), or
    • Providing alternative escalation instructions if tagging is not appropriate

Would you like me to suggest alternative escalation patterns commonly used in open-source projects?

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

In `@SUPPORT.md` at line 3, Confirm with `@ptisnovs` whether they should be tagged
for urgent issues and then replace the HTML FIXME comment in the "For urgent
issues..." line: either explicitly instruct "For urgent issues, tag `@ptisnovs` in
the issue" if they agree, or update the guidance to an alternative escalation
path (e.g., "For urgent issues, open an issue, add the 'urgent' label, and
notify the maintainers via the org Slack `#support` or mention the `@maintainers`
team") so the FIXME is removed and the urgent-escalation step is fully
specified.

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