Skip to content

docs: resolve merge conflicts in CONTRIBUTING.md (closes #654)#662

Open
clubanderson wants to merge 2 commits into
projectbluefin:mainfrom
clubanderson:docs/fix-contributing-conflicts
Open

docs: resolve merge conflicts in CONTRIBUTING.md (closes #654)#662
clubanderson wants to merge 2 commits into
projectbluefin:mainfrom
clubanderson:docs/fix-contributing-conflicts

Conversation

@clubanderson
Copy link
Copy Markdown

@clubanderson clubanderson commented Jun 4, 2026

Resolves the merge conflicts in PR #650. Closes #654

Summary by CodeRabbit

  • Documentation
    • Updated contribution guidelines with improved organization, expanded development setup instructions, clarified testing procedures for both unit and visual tests, enhanced PR workflow requirements, and more detailed translation contribution guidance.

ci-maintainer and others added 2 commits May 24, 2026 21:53
- Add prerequisites table (Node.js 18+, npm, optional just)
- Add local development setup steps
- Add repository structure section with component map
- Add code style / ESLint formatting guidance
- Add PR workflow with DCO sign-off instructions
- Add conventional commit examples
- Retain pointer to docs site and OS-image repos

Addresses: guide bead 27949a40 — CONTRIBUTING.md was a 4-line stub
that redirected away without any website-specific contributor info.

Signed-off-by: ci-maintainer <ci-maintainer@projectbluefin.hive>
Merge PR projectbluefin#650 (docs/contributing-guide) with current main by combining
both versions into one comprehensive guide:

- Keep PR projectbluefin#650's structured Prerequisites table, numbered Local Development
  steps, HMR note, Repository Structure tree, Making Changes section,
  detailed Code Style rules, DCO sign-off instructions, and Questions section
- Keep main's Testing section (unit tests + Playwright navbar visual tests)
- Keep main's Security Issues section
- Merge commands table to include all commands from both versions
- Consolidate Translations subsection from both the i18n section (main)
  and the Translations subsection (PR projectbluefin#650)

Closes projectbluefin#654
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 4, 2026

Review Change Stack

📝 Walkthrough

Walkthrough

CONTRIBUTING.md is comprehensively rewritten to provide clearer, more detailed guidance for contributors to the Project Bluefin website. The guide now explicitly describes the repository as a Vite + Vue 3 multi-page application, expands development setup and command instructions, clarifies translation and component workflows, updates testing procedures, and refines the pull request submission and community guidelines sections.

Changes

Bluefin Contributing Guide Update

Layer / File(s) Summary
Onboarding and Local Development Setup
CONTRIBUTING.md
Introductory scope updated to describe the Project Bluefin website and its role in the broader ecosystem. Prerequisites and initial setup instructions expanded with tooling/version expectations and dev-server commands. Development command guidance refined with build, preview, lint, and typecheck instructions.
Repository Structure Documentation
CONTRIBUTING.md
Repository structure documentation rewritten to reflect current directory layout and multi-page Vite setup with separate HTML entry points mounting distinct Vue roots for dakota, knuckle, and bluespeed sub-applications.
Development Practices and Code Standards
CONTRIBUTING.md
"Making Changes" guidance reorganized into component/editing and translation workflows with explicit folder locations and filename conventions. Code style/formatting instructions updated to describe ESLint-based approach and required lint:fix workflow. Testing section expanded with explicit Vitest commands and Playwright navbar visual test instructions including dev-server setup.
PR Submission Workflow and Community Guidelines
CONTRIBUTING.md
Pull request workflow rewritten with updated step instructions, Conventional Commits guidance, and clearer Developer Certificate of Origin (DCO) signoff procedure. Security reporting and community questions sections reformatted as consistent end-of-file subsections with updated links.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

A guide rewritten, clear and bright,
With setup steps that feel just right,
From intro to the final check,
Our Bluefin docs are now in spec! 🐰✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: resolving merge conflicts in CONTRIBUTING.md, which is the primary objective of this PR.
Linked Issues check ✅ Passed The PR successfully resolves the merge conflicts in CONTRIBUTING.md as required by issue #654, enabling PR #650 to merge.
Out of Scope Changes check ✅ Passed All changes are scoped to CONTRIBUTING.md and directly address the merge conflict resolution objective specified in issue #654.
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

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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CONTRIBUTING.md`:
- Line 86: Remove the stray character and fix alignment for the repository tree
entry for locales/ by replacing the malformed line "locales/          # i18n
translation files (JSON)   ├" with a clean, consistent entry like "locales/     
# i18n translation files (JSON)" so the directory map renders the same as
surrounding entries and the stray '├' is eliminated.
- Around line 42-43: CONTRIBUTING.md currently contradicts the justfile: verify
the justfile's serve: target (which runs "npm run dev") and update
CONTRIBUTING.md so "just serve" is documented only as the development server
(running npm run dev); also identify and document the actual just target used
for production preview (or add one to the justfile) so the doc's
production-preview instructions reference the correct target instead of reusing
"just serve".
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 5b7dcafa-b8b8-4bd4-b3f3-01aae95815c1

📥 Commits

Reviewing files that changed from the base of the PR and between b88c145 and 324f61e.

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

Comment thread CONTRIBUTING.md
Comment on lines +42 to +43
# or, if you have just installed:
just serve
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify how `just serve` is actually defined.
fd -i '^justfile$|\.justfile$' --exec sh -c 'echo "==> $1"; sed -n "1,220p" "$1"' sh {}

Repository: projectbluefin/website

Length of output: 292


Fix inconsistent documentation for just serve in CONTRIBUTING.md
justfile defines serve: to run npm run dev, but CONTRIBUTING.md describes just serve as both a dev-server command (lines 42-43) and a production preview (lines 59-60). Make these consistent with the actual just target(s), or document the correct target for production preview.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CONTRIBUTING.md` around lines 42 - 43, CONTRIBUTING.md currently contradicts
the justfile: verify the justfile's serve: target (which runs "npm run dev") and
update CONTRIBUTING.md so "just serve" is documented only as the development
server (running npm run dev); also identify and document the actual just target
used for production preview (or add one to the justfile) so the doc's
production-preview instructions reference the correct target instead of reusing
"just serve".

Comment thread CONTRIBUTING.md
│ ├── dakota/ # Dakota-specific components
│ └── knuckle/ # Knuckle-specific components
├── composables/ # Reusable Vue composables
locales/ # i18n translation files (JSON) ├
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Repository tree entry for locales/ appears malformed.

The stray and alignment on this line make the directory map ambiguous. Clean this line so the tree renders consistently with the surrounding entries.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CONTRIBUTING.md` at line 86, Remove the stray character and fix alignment for
the repository tree entry for locales/ by replacing the malformed line "locales/
# i18n translation files (JSON)   ├" with a clean, consistent entry like
"locales/          # i18n translation files (JSON)" so the directory map renders
the same as surrounding entries and the stray '├' is eliminated.

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.

resolve: merge conflicts in CONTRIBUTING.md — PR #650

2 participants