devloperdevesh / devloperdevesh/FaultPlane

docs: improve contributor development guide

Open
#11 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement good first issue help wanted
Dominant language
Go
Stars
2
Forks
1
Avg merge
14m
Merged PRs (30d)
57

Description

Problem

New contributors need clear guidance about project architecture, development workflow, and testing commands.


Proposed Solution

Improve contributor documentation.

Include:

  • Local setup instructions
  • Repository architecture overview
  • Development commands
  • Testing workflow
  • Contribution process

Alternatives

Existing documentation can remain unchanged, but onboarding becomes harder for new contributors.


Use Case

Better documentation helps developers understand the project and submit quality contributions.


Additional Notes

Related files:

  • CONTRIBUTING.md
  • README.md
  • docs/

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading CONTRIBUTING.md, README.md, and the contents of docs/ to identify gaps in local setup, architecture, development commands, testing workflow, and contribution guidance. Done means these areas are clearly documented for new contributors across the related files.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.