Skip to content

docs: improve contributing.md guidelines#1081

Open
msgem0523 wants to merge 2 commits into
Vets-Who-Code:masterfrom
msgem0523:feature/add-contributing-md
Open

docs: improve contributing.md guidelines#1081
msgem0523 wants to merge 2 commits into
Vets-Who-Code:masterfrom
msgem0523:feature/add-contributing-md

Conversation

@msgem0523
Copy link
Copy Markdown

Summary

Improved and expanded the CONTRIBUTING.md file to provide clearer guidance for new contributors.

Changes Made

  • Enhancing "Getting Started" section with full setup instructions (install, env, migrations, dev server)
  • Added cleared development workflow steps
  • Expanded Pull Request process with checklist
  • Improved commit message guidelines formatting and clarity
  • Added testing and code style expectations
  • Fixed markdown formatting issues (including broken links)

Why This Matters

These updates makes it easier for new contributors to understand how to set up the project, follow the practices, and contribute effectively.

Testing

  • Documentation update only
  • No code changes required

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 25, 2026

@msgem0523 is attempting to deploy a commit to the vetswhocode-web-app Team on Vercel.

A member of the Team first needs to authorize it.

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
vets-who-code-app Error Error May 7, 2026 0:08am

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates contributor-facing documentation to better guide new developers through setup and contribution workflows, and removes personal UI theming from the shared VS Code workspace settings.

Changes:

  • Expanded contributing.md with step-by-step local setup, workflow guidance, PR checklist, commit message rules, and testing expectations.
  • Cleaned up .vscode/settings.json by removing workbench color customizations / Peacock color settings.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File Description
contributing.md Major rewrite/expansion of contribution and setup guidance; includes new sections and checklists (but contains several typos, formatting issues, and some tooling/link inconsistencies).
.vscode/settings.json Removes editor theming customizations to keep workspace settings focused on shared dev configuration.
Comments suppressed due to low confidence (1)

contributing.md:154

  • This section says the project uses Prettier and ESLint, but the repo scripts/config use Biome (biome.json, npm run lint runs biome lint). Update the tooling references (and the suggested commands, if needed) so contributors follow the actual formatter/linter used in this codebase.
## Code Style and Linting

- We use [Prettier](https://prettier.io/) and [ESLint](https://eslint.org/) for code styling and linting. Make sure your code adheres to our configurations.
- Run the linter before submitting a PR to ensure your code passes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread contributing.md
- [Code of Conduct](#code-of-conduct)
- [Getting Started](#getting-started)
- [Fork and Clone the Repository](#fork-and-clone-the-repository)
- [Fining Issues to Work on](#fining-issues-to-work-on)
Comment thread contributing.md
Comment on lines +62 to +66
5. Set up environment variables:
```bash
cp .env.example .env.local
```
Update .env.local with the required values. Check the README for configuration details
Comment thread contributing.md
npm run dev
```

## Fining Issues to Work on
Comment thread contributing.md
Comment on lines +89 to +91
Before opening a bug report:
-Search existing issues to make sure the bug has not already been reported.
If it has not been reported, open a new issue.
Comment thread contributing.md
- Check if the feature has already been requested.
- If it hasn't, open a new Issue with a clear title and detailed description of the feature you'd like to see.
Before requesting a feature:
-Check existing issues to see if the feature has already been suggested.
Comment thread contributing.md
git push origin feature/your-feature-name
```

2. Opena Pull Request against the original repository.
Comment thread contributing.md
Comment on lines +144 to +148
- Code follows the project style guidlines
- Tests pass locally
- New code has tests when needed
- Documentation has now been upgraded when needed
- Commit message follow project conventions
Comment thread contributing.md
If you have any questions or need further assistance:
- Open an issue
- Check existing Issues and Pull Requests
- Reach out to [Jerome Hardaway][https://github.com/jeromehardaway].
Copy link
Copy Markdown
Contributor

@jeromehardaway jeromehardaway left a comment

Choose a reason for hiding this comment

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

Asked for a few changes, other than that good work!

Comment thread .vscode/settings.json
Comment thread contributing.md

1. Create a new branch for your work:
```bash
git checkout -b feature/your-feature-name
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.

Can we have it so you say the label/username/issue

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Review / PR

Development

Successfully merging this pull request may close these issues.

3 participants