Each & every project we build and/or maintain has been a possibility due to the community efforts. And as such without help from the community itself, the projects would've been a distant dream only! As such, while we welcome all sorts of contributions to developing our community website, we ask the contributors to abide by certain rules & guidelines. These guidelines help us ensure:
- Development practices are uniform.
- Bug reports follow a standard procedure which makes it easier to debug & resolve certain issues quicker.
- Submitting bug fixes, patches, feature requests through Pull Requests (PRs).
- The details & examples to share when proposing a new website enhancement or feature request.
As such this current document lists down such guidelines in complete detail which every contributor should follow while contributing to the project.
Do note, the statements detailed in this document aren't set in stone & individual contributors are expected to use their best judgement when developing and/or contributing to the project. If you ever feel, certain portions of this document could use a rephrasing? Please do not hesitate to report it to us & open a PR referencing it!
First of, our community welcomes people from all sorts of areas & expertise with varying years of experience. As such we ask you to be civil when interacting with another community be it on GitHub or elsewhere.
To enforce a civil & mature engagement among community members we drafted the
Code of Conduct. If you find anyone breaking the T&Cs of the aforementioned
document please report us about the incident on over our email -
contact.developersindia@gmail.com.
Note: Please don't file an issue to ask a question. You'll get faster results by using the resources below.
- Check the Issue/Discussion threads to see if your query already exists or not!
- If it's a quick short answer which you believe one of the admin/maintainers can respond to real quick, our DMs are open to you.
- Join our Discord server & have a great chat there! (Don't forget to read the rules & guidelines there as well!)
We use GitHub issues to track public bugs, weird features, broken URLs, design discrepancies & so on. More specifically, any thing out of the ordinary which shouldn't really exist in a website is tracked on our bug tracker.
You can report a bug by opening a new issue, it's that easy! But before reporting an issue, please put in some effort & identify if similar reports have already been created by a previous individual.
Note: If you find a Closed issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.
- Check if the content is being delivered to your browser. Sometimes a quick Hard Refresh(Shift + Ctrl + R) might resolve the issue.
- Determine if such a bug report has already been reported earlier or not.
- Take a screenshot of the bug if possible & take note of the Browser details.
Great Bug Reports tend to have:
- Use a clear & descriptive title to identify the issue & for obvious SEO reasons.
- Describe the exact steps which reproduce the problem in as many details as possible.
- Provide specific examples to demonstrate the steps. Include links to files or GitHub projects, or copy/pasteable snippets, which you use in those examples. If you're providing snippets in the issue, use [Markdown code blocks][8.
- Describe the behaviour you observed after following the steps and point out what exactly is the problem with that behaviour.
- Explain which behaviour you expected to see instead and why.
- Include screenshots and animated GIFs which show you following the described steps and clearly demonstrate the problem. If you use the keyboard while following the steps, record the GIF with this tool: ShareX.
- If the problem wasn't triggered by a specific action, describe what you were doing before the problem happened and share more information using the guidelines below.
Project maintainers & authors love thorough bug reports!
All projects maintained under the developersIndia banner are free & open-source. Hence we welcome public opinion on features & enhancements! Further, this section of the document will help you understand how to draft a detailed enhancement suggestion. Following these guidelines helps maintainers and the community understand your suggestion 📝 and find related suggestions 🔎.
Before creating enhancement suggestions, please check this list as you might find out that you don't need to create one. When you are creating an enhancement suggestion, please include as many details as possible. Fill in the template, including the steps that you imagine you would take if the wiki entry you're requesting existed.
Unsure where to begin contributing to the project? You can start by looking
through these good-first-issues and help-wanted issues:
- Good First Issues - issues which should only require a few lines of code, and a test or two.
- Help Wanted Issues - issues which should be a bit more involved
than
good-first-issuesissues.
Both issue lists are sorted by the total number of comments. While not perfect, the number of comments is a reasonable proxy for an impact a given change will have.
Before you can write your first ever contribution to the project, you need to have a development environment setup locally on your machine. As such this current section will document the steps & procedure you'll need to take for setting up the development environment.
Prerequisite Tools Necessary for Local Development:
Before proceeding ahead with your contributions, please read the instructions in this section thoroughly. And you'll need to have the following tools installed locally on your system to develop the website.
Once installed you can verify if the software are working properly or not by invoking the following commands;
# Verify the mdbook CLI tool is installed on your system
node --version
# Example output: version v18.7.0
# Verify npm is installed & available
npm --version
# Example output: 8.15.0
# Verify git exists & works as expected
git --version
# Example output: git version v2.4.21With the necessary prerequisite tools installed & verified, you should now fork the project. if you've never forked a GitHub project before, check the official GitHub docs or refer to this YouTube video.
This forked repository will be your remote copy of the soure code. And
you're free to do whatever you wish to it without ever worrying about messing
things up in the upstream (as in the main) repository. But to be even safer,
its particularly recommended to create git branches.
That said, the next few sections will help you further on setting up the project for local development.
Setting Up the Project for Local Development
Once you've access to a personal fork of the project, you're free to make changes to it before sharing a PR with us! So let's see how you can get started with writing your first line of code for the project!
-
Clone your forked remote repository to your local development machine using;
git clone git@github.com:<YOUR_GITHUB_NAME/website>
-
With the source code downloaded to your local machine its now time to install the dependencies for the project. So change in to the project directory & run the following command.
# This will install all the project dependencies locally. npm install -
Once the dependencies are installed, check if the project works as expected.
# This will start a development version of the website & will be accessible # in this URL - http://localhost:3000 npm run dev
If all goes well & good, you should now see the development version of the website in this URL - http://localhost:3000. And if you don't see a website, please reach out to us & we'll help you figure out something.
NOTE: As mentioned earlier, even if you fork the repository, its always
best practice to create a git branch (refer to the documentations for more
information). You can create a branch by running this command -
git checkout -b <BRANCH_NAME>. Once you've worked on your branch, push the
commits to your forked remote repository & then create a PR. With the PR
created give us moderators some time to review it. And if wait for
approval/feedback before it can be merged to the main branch of the repository.
We welcome all sorts of contributions to the project, be it triaging issues, reporting bugs & breaking changes and/or even taking up maintenance responsibilities. And all contributions to the project are performed under a voluntary basis for the developersIndia community.
As such to protect the interests of the contributors of the project, we're distributing the project under the MIT License. To read & learn about the terms & conditions (T&Cs) of the license, please check the LICENSE document.
That said, all contributions to the project will be distributed under the T&Cs of the MIT License as well. We also assume, by contributing to the project, you're then accepting the T&Cs of the open-source license we distribute our project under.
If you feel there's something missing and/or the T&Cs are too restricted (or otherwise) please report it to us & open a PR explaining your reasoning. We'll gladly welcome your PR as long as the changes to the T&Cs are justifiable enough.
We maintain the project in this repository on a voluntary basis outside work hours. As such, we appreciate each & every helping hands our contributors provide us. One task we desparately need help with is triaging issues, discussions & PRs. And believe it or not, this is one task which is extremely appreciated by the maintainers, so if you can contribute responding and/or triaging it be a massive help for us!
That said, if you would like to contribute to the project by...
- Triaging through issues & helping the maintainers identify the type of issue/PRs.
- Respond to contributors with their queries & discussions.
- Marking bad PRs as spam and/or duplicate issue threads as
duplicate.
...then this section of the document will guide you through.
That said, we track:
- Bugs, feature requests & such through Issue threads.
- Discussions on breaking changes, enhancements & feature requests through Discussion threads.
- And source code updates and/or changes through Pull Requests.
Issue threads & PRs are categorized with the following labels:
| Issue Labels | Desciption |
|---|---|
bug |
Something isn't working |
dependencies |
Pull requests that update a dependency file |
documentation |
Improvements or additions to documentation |
duplicate |
This issue or pull request already exists |
enhancement |
New feature or request |
good first issue |
Good for newcomers |
help wanted |
Extra attention is needed |
invalid |
This doesn't seem right |
question |
Further information is requested |
wontfix |
This will not be worked on |
More such labels will be added & updated as & when required.
You can triage through specific categories of issue threads or PRs if that's
what you're looking for. For example, if you're a first-time contributor to the
project, you could look into issue threads labeled with good first issue
or help wanted.
NOTE: If you notice we missed adding someone (which could include you as well) to the list of contributors, please add a comment on the lines of;
<!-- remove the square brackets and choose appropriate words -->
@all-contributors please add @user for [code, design, bug, infra, doc, tool, ideas]
Additionally, please take a look the All Contributors docs for further information on how to use it.
The contributing guidelines detailed in this document pertains only to this one specific project which is hosted in this repository. More specifically, all the guidelines detailed in the document are only applicable towards development and/or maintenance of the developersIndia website.
If you would like to read more about our community guidelines, please find them on the following resources:
HAPPY CONTRIBUTING! 😄