parse-community / parse-community/parse-server

Improve contribution guide

Open
#7,100 7 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

type:meta
Dominant language
JavaScript
Stars
21.4k
Forks
4.8k
Avg merge
7h 45m
Merged PRs (30d)
11

Description

New Issue Checklist
Issue Description

The Contribution Guide could benefit from an overhaul to:

  • be more accessible for new developers by reducing required pre-existing knowledge
  • mitigate bug risks by documenting processes for common changes
  • facilitate code quality by adding code style guidelines

The contribution guide currently only contains descriptions of the technical set-up required to make changes to Parse Server, described in way that assumes a level of pre-existing knowledge about tools and processes that has shown in some cases to discourage new developers from creating PRs. Parse is not just an entry point for new developers for its use as a backend but also when it comes to its development and making first steps into open-source contribution. A more accessible guide benefits both developers and further development of Parse.

Suggested changes
  • Add process: Add new Parse Error -> #7075
  • Add process: Add new Parse Server configuration parameter -> #7075
  • Add: Code style guide
  • Add: PR guide (GitHub guide is too verbose and not suitable as a reference for new developers)
  • Reformat document to increase readability
  • Rewrite guides into step-by-step instructions to help new developers

Please feel free to grab one or propose others.

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 locating and reading the current Contribution Guide in the Parse Server repository, then review the suggested changes in this issue, including the code style guide, PR guide, readability improvements, and step-by-step instructions. Confirm which unchecked area is still needed with maintainers; done means the selected guidance is documented clearly for new contributors and reflects the existing contribution processes.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, nodejs
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.