Skip to content

Add CONTRIBUTING.md#150

Merged
carole-lavillonniere merged 1 commit intomainfrom
george/add-contributing
Mar 23, 2026
Merged

Add CONTRIBUTING.md#150
carole-lavillonniere merged 1 commit intomainfrom
george/add-contributing

Conversation

@gtsiolis
Copy link
Copy Markdown
Member

Add a basic and new CONTRIBUTING.md with contribution guidelines specific to lstk.

This will replace the currently inherited CONTRIBUTING.md[1] guidelines from the GitHub organization template.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 21, 2026

📝 Walkthrough

Walkthrough

Added a new CONTRIBUTING.md documentation file establishing contribution guidelines for the lstk CLI project. Covers prerequisites, build and test procedures, code style standards, repository architecture overview, contribution workflows for new commands and components, and testing requirements.

Changes

Cohort / File(s) Summary
Documentation
CONTRIBUTING.md
New contribution guidelines documenting prerequisites (Go 1.21+, Docker, Make), build/test commands, code style rules, repository architecture, contribution workflows via skills, and PR submission steps.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • carole-lavillonniere
  • silv-io
  • anisaoshafi
🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Add CONTRIBUTING.md' accurately and concisely describes the main change: adding a new contribution guidelines document to the repository.
Description check ✅ Passed The description clearly explains that this PR adds a repository-specific CONTRIBUTING.md to replace the organization template's inherited guidelines, which is directly related to the changeset.

✏️ 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 george/add-contributing

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

@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

🧹 Nitpick comments (1)
CONTRIBUTING.md (1)

38-38: Clarify output.Sink usage to steer contributors to helper emitters.

Line 38 is directionally correct, but it may help to explicitly say “use output.Emit* helpers” so contributors don’t try to call sink methods directly.

✍️ Suggested wording tweak
-- No direct stdout/stderr printing; use `output.Sink` for user output, `log.Logger` for diagnostics
+- No direct stdout/stderr printing; use `output.Sink` with `output.Emit*` helpers for user output, `log.Logger` for diagnostics
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CONTRIBUTING.md` at line 38, Clarify the CONTRIBUTING guidance to instruct
contributors to use the output.Emit* helper functions instead of calling
output.Sink methods directly: update the sentence mentioning output.Sink to read
something like “Use output.Sink for user output via the provided helper emitters
(use output.Emit* helpers) and log.Logger for diagnostics,” ensuring you
reference output.Sink and the output.Emit* helpers so readers know to prefer the
Emit* helper functions rather than invoking Sink methods directly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CONTRIBUTING.md`:
- Around line 60-62: Update the fenced code blocks that show the inline CLI
examples so they include a language identifier (use "text") to satisfy
markdownlint MD040; specifically change the blocks containing "/add-command
<name>", "/add-event <EventName>", "/add-component <name>" (and the similar
examples referenced around lines 69-71 and 78-80) from ``` to ```text so each
example fence is annotated.

---

Nitpick comments:
In `@CONTRIBUTING.md`:
- Line 38: Clarify the CONTRIBUTING guidance to instruct contributors to use the
output.Emit* helper functions instead of calling output.Sink methods directly:
update the sentence mentioning output.Sink to read something like “Use
output.Sink for user output via the provided helper emitters (use output.Emit*
helpers) and log.Logger for diagnostics,” ensuring you reference output.Sink and
the output.Emit* helpers so readers know to prefer the Emit* helper functions
rather than invoking Sink methods directly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: 798e2465-9265-4d86-848e-cf8560c10b8c

📥 Commits

Reviewing files that changed from the base of the PR and between 1aa2f2e and 4d7762e.

📒 Files selected for processing (1)
  • CONTRIBUTING.md

Comment on lines +60 to +62
```
/add-command <name>
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Add languages to fenced code blocks to satisfy markdownlint.

markdownlint warning MD040 is valid here. Please annotate these fences with a language.

🛠️ Proposed doc fix
 Use the skill:
-```
+```text
 /add-command <name>

@@
Use the skill:
- +text
/add-event

@@
Use the skill:
-```
+```text
/add-component <name>
</details>


Also applies to: 69-71, 78-80

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.21.0)</summary>

[warning] 60-60: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @CONTRIBUTING.md around lines 60 - 62, Update the fenced code blocks that
show the inline CLI examples so they include a language identifier (use "text")
to satisfy markdownlint MD040; specifically change the blocks containing
"/add-command ", "/add-event ", "/add-component " (and
the similar examples referenced around lines 69-71 and 78-80) from ``` to

@carole-lavillonniere carole-lavillonniere merged commit 142de18 into main Mar 23, 2026
8 checks passed
@carole-lavillonniere carole-lavillonniere deleted the george/add-contributing branch March 23, 2026 07:29
@gtsiolis
Copy link
Copy Markdown
Member Author

Thanks for merging this, @carole-lavillonniere! 👾

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