Skip to content

Contributing guidelines#1282

Merged
tisnik merged 1 commit intolightspeed-core:mainfrom
tisnik:contributing-guidelines
Mar 6, 2026
Merged

Contributing guidelines#1282
tisnik merged 1 commit intolightspeed-core:mainfrom
tisnik:contributing-guidelines

Conversation

@tisnik
Copy link
Contributor

@tisnik tisnik commented Mar 6, 2026

Description

Contributing guidelines

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

Summary by CodeRabbit

  • Documentation
    • Added comprehensive contributor guidelines covering goals, development setup, branching/PR workflow, review and approval processes, maintainer roles, and AI-assistant usage notes.
    • Added a presentation version of the guidelines for easy, slide-based viewing.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 6, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b775a311-a615-4e58-bb59-b888f2f08b8b

📥 Commits

Reviewing files that changed from the base of the PR and between aacf332 and b1311f9.

📒 Files selected for processing (2)
  • docs/demos/lcore/contributing_guidelines.html
  • docs/demos/lcore/contributing_guidelines.md

Walkthrough

Adds two documentation assets: a Markdown contributor guide for Lightspeed Core and a Reveal.js-based HTML presentation that renders that guide as slides with standard Reveal configuration and plugins.

Changes

Cohort / File(s) Summary
Contributor Guidelines
docs/demos/lcore/contributing_guidelines.md
New Markdown document with contributor guidelines: goals, dev setup, branching/PR workflow, AI-assistant notes, licensing, maintainers, and PR approval process.
Reveal.js Presentation
docs/demos/lcore/contributing_guidelines.html
New HTML file embedding Reveal.js assets, mounting the Markdown slides, and initializing Reveal with controls, progress, history, centering, and Markdown/Highlight plugins.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 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 'Contributing guidelines' accurately describes the main change in the PR, which adds a new contributing guidelines document.
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

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

🧹 Nitpick comments (1)
docs/demos/lcore/contributing_guidelines.html (1)

21-21: Unused plugin: notes.js is loaded but not initialized.

The notes.js script is included but RevealNotes is not added to the plugins array, so speaker notes functionality won't be available. Either add it to the plugins or remove the script include.

Option 1: Add RevealNotes to plugins
-                            plugins: [ RevealMarkdown, RevealHighlight ]
+                            plugins: [ RevealMarkdown, RevealHighlight, RevealNotes ]
Option 2: Remove unused script
-        <script type="application/javascript" src="plugin/notes/notes.js"></script>

Also applies to: 30-30

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

In `@docs/demos/lcore/contributing_guidelines.html` at line 21, The notes.js
script is included but never registered as a plugin so RevealNotes functionality
is unused; either remove the <script> include for plugin/notes/notes.js, or
register the plugin by adding RevealNotes to the Reveal initialization plugins
array (e.g., include RevealNotes in the plugins list passed to Reveal.initialize
or Reveal.configure where Reveal is bootstrapped) so speaker notes work
correctly; ensure the symbol RevealNotes is imported/available before adding it.
🤖 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/demos/lcore/contributing_guidelines.md`:
- Line 24: Typo in the contributing guidelines bullet: replace "Be making clear
what are requirements for contributors and LCORE team" with "By making clear
what are requirements for contributors and LCORE team" — edit the line in
contributing_guidelines.md (the bullet text) to change "Be" to "By" so the
sentence reads correctly.
- Line 16: Replace the phrase "as effective as possible" with the adverbial form
"as effectively as possible" in the sentence in contributing_guidelines.md (the
line starting "* To be able to verify, review, test, and merge changes as
effective as possible") so the verb phrase is properly modified.
- Around line 65-66: Fix the two grammatical issues in the
contributing_guidelines.md text: change the phrase "seems to has" to "seems to
have" and replace "unrelevant changes" with "irrelevant changes" so the
sentences read correctly and professionally, updating the exact phrases "seems
to has" and "unrelevant changes" in the document.

---

Nitpick comments:
In `@docs/demos/lcore/contributing_guidelines.html`:
- Line 21: The notes.js script is included but never registered as a plugin so
RevealNotes functionality is unused; either remove the <script> include for
plugin/notes/notes.js, or register the plugin by adding RevealNotes to the
Reveal initialization plugins array (e.g., include RevealNotes in the plugins
list passed to Reveal.initialize or Reveal.configure where Reveal is
bootstrapped) so speaker notes work correctly; ensure the symbol RevealNotes is
imported/available before adding it.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3010186e-91ba-4bd9-9b6e-d444a883bea6

📥 Commits

Reviewing files that changed from the base of the PR and between a7da069 and aacf332.

📒 Files selected for processing (2)
  • docs/demos/lcore/contributing_guidelines.html
  • docs/demos/lcore/contributing_guidelines.md

@tisnik tisnik force-pushed the contributing-guidelines branch from aacf332 to b1311f9 Compare March 6, 2026 14:36
@tisnik tisnik merged commit 9bb4017 into lightspeed-core:main Mar 6, 2026
19 of 22 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.

1 participant