mirror of
https://github.com/kamranahmedse/developer-roadmap.git
synced 2025-08-01 06:50:26 +02:00
Update contribution docs (#7506)
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# Contribution
|
||||
# ✨ Contribution Guidelines ✨
|
||||
|
||||
First of all, thank you for considering to contribute. Please look at the details below:
|
||||
|
||||
@@ -8,6 +8,7 @@ First of all, thank you for considering to contribute. Please look at the detail
|
||||
- [Adding Projects](#adding-projects)
|
||||
- [Adding Content](#adding-content)
|
||||
- [Guidelines](#guidelines)
|
||||
- [Good vs. Not So Good Contributions](#good-vs-not-so-good-contributions)
|
||||
|
||||
## Hacktoberfest Contributions
|
||||
|
||||
@@ -15,10 +16,10 @@ We are taking part in [Hacktoberfest 11](https://hacktoberfest.com/)!
|
||||
|
||||
Before you start to contribute to our project in order to satisfy [Hacktoberfest requirements](https://hacktoberfest.com/participation/#contributors), please bare in mind the following:
|
||||
|
||||
* There is not a Hacktoberfest t-shirt this year [(see their FAQ)](https://hacktoberfest.com/participation/#faq).
|
||||
* There is not an infinite opportunity to contribute to the roadmap.sh project.
|
||||
- There is *not* a Hacktoberfest t-shirt this year [(see their FAQ)](https://hacktoberfest.com/participation/#faq)
|
||||
- There is *not* an infinite opportunity to contribute to the roadmap.sh project.
|
||||
|
||||
### Hacktoberfest Specific Contribution rules
|
||||
### Hacktoberfest Specific Contribution Rules
|
||||
|
||||
As Hacktoberfest attracts a lot of contributors (which is awesome), it does require a more rigid and strictly enforced set of guidelines than the average contribution.
|
||||
|
||||
@@ -61,11 +62,12 @@ Learn more from the following resources:
|
||||
|
||||
Contributions to the project that meet these requirements will be given the label `hacktoberfest-accepted` and merged, contributions that do not meet the requirements will simply be closed.
|
||||
|
||||
Any attempts at spam PRs will be given the `spam` tag. If you recieve 2 `spam` tags against you, you will be [disqualified from Hacktoberfest](https://hacktoberfest.com/participation/#spam).
|
||||
Any attempts at spam PRs will be given the `spam` tag. If you receive 2 `spam` tags against you, you will be [disqualified from Hacktoberfest](https://hacktoberfest.com/participation/#spam).
|
||||
|
||||
## New Roadmaps
|
||||
|
||||
For new roadmaps, you can either:
|
||||
|
||||
- Submit a roadmap by providing [a textual roadmap similar to this roadmap](https://gist.github.com/kamranahmedse/98758d2c73799b3a6ce17385e4c548a5) in an [issue](https://github.com/kamranahmedse/developer-roadmap/issues).
|
||||
- Create an interactive roadmap yourself using [our roadmap editor](https://draw.roadmap.sh/) & submit the link to that roadmap in an [issue](https://github.com/kamranahmedse/developer-roadmap/issues).
|
||||
|
||||
@@ -73,10 +75,10 @@ For new roadmaps, you can either:
|
||||
|
||||
For the existing roadmaps, please follow the details listed for the nature of contribution:
|
||||
|
||||
- **Fixing Typos** — Make your changes in the [roadmap Markdown file](https://github.com/kamranahmedse/developer-roadmap/tree/master/src/data/roadmaps) and submit a [PR](https://github.com/kamranahmedse/developer-roadmap/pulls).
|
||||
- **Fixing Typos** — Make your changes in the [roadmap markdown file](https://github.com/kamranahmedse/developer-roadmap/tree/master/src/data/roadmaps) and submit a [PR](https://github.com/kamranahmedse/developer-roadmap/pulls).
|
||||
- **Adding or Removing Nodes** — Please open an [issue](https://github.com/kamranahmedse/developer-roadmap/issues) with your suggestion.
|
||||
|
||||
**Note:** Please note that our goal is <strong>not to have the biggest list of items</strong>. Our goal is to list items or skills most relevant today.
|
||||
**Note:** Please note that our goal is **not to have the biggest list of items**. Our goal is to list items or skills most relevant today.
|
||||
|
||||
## Adding Projects
|
||||
|
||||
@@ -84,7 +86,7 @@ If you have a project idea that you think we should add to the roadmap, feel fre
|
||||
|
||||
The detailed format for the issue should be as follows:
|
||||
|
||||
```
|
||||
```md
|
||||
## What is this project about?
|
||||
|
||||
(Add an introduction to the project.)
|
||||
@@ -112,14 +114,14 @@ Find [the content directory inside the relevant roadmap](https://github.com/kamr
|
||||
|
||||
Please adhere to the following style when adding content to a topic:
|
||||
|
||||
```
|
||||
```md
|
||||
# Topic Title
|
||||
|
||||
(Content)
|
||||
|
||||
Visit the following resources to learn more:
|
||||
|
||||
- [@type@Description of link](Link)
|
||||
- [@type@Title/Description of Link](Link)
|
||||
```
|
||||
|
||||
`@type@` must be one of the following and describe the type of content you are adding:
|
||||
@@ -131,7 +133,7 @@ Visit the following resources to learn more:
|
||||
- `@podcast@`
|
||||
- `@video@`
|
||||
|
||||
It's important to add a valid type, this will help us categorize the content and display it properly on the roadmap.
|
||||
It's important to add a valid type, this will help us categorize the content and display it properly on the roadmap. The order of the links based on type is same as above.
|
||||
|
||||
## Guidelines
|
||||
|
||||
@@ -151,20 +153,21 @@ It's important to add a valid type, this will help us categorize the content and
|
||||
|
||||
If you are planning to contribute by adding content to the roadmaps, I recommend you to clone the repository, add content to the [content directory of the roadmap](./src/data/roadmaps/) and create a single PR to make it easier for me to review and merge the PR.
|
||||
|
||||
- <p><strong>Write meaningful commit messages</strong><br >
|
||||
- <p><strong>Write meaningful commit messages</strong><br/>
|
||||
|
||||
Meaningful commit messages help speed up the review process as well as help other contributors gain a good overview of the repositories commit history without having to dive into every commit.
|
||||
|
||||
</p>
|
||||
- <p><strong>Look at the existing issues/pull requests before opening new ones</strong></p>
|
||||
|
||||
### Good vs. Not So Good Contributions
|
||||
## Good vs. Not So Good Contributions
|
||||
|
||||
<strong>Good</strong>
|
||||
|
||||
- New Roadmaps.
|
||||
- Engaging, fresh content links.
|
||||
- Engaging and fresh content links.
|
||||
- Typos and grammatical fixes.
|
||||
- Enhanced Existing Content.
|
||||
- Content copy in topics that do not have any (or minimal copy exists).
|
||||
|
||||
<strong>Not So Good</strong>
|
||||
@@ -174,3 +177,7 @@ It's important to add a valid type, this will help us categorize the content and
|
||||
- Non-English content.
|
||||
- PR's that don't follow our style guide, have no description, and a default title.
|
||||
- Links to your own blog articles.
|
||||
|
||||
***
|
||||
|
||||
Have a look at the [License](./license) file.
|
||||
|
5
license
5
license
@@ -1,7 +1,6 @@
|
||||
Everything including text and images in this project are protected by the copyright laws.
|
||||
You are allowed to use this material for personal use but are not allowed to use it for
|
||||
any other purpose including publishing the images, the project files or the content in the
|
||||
images in any form either digital, non-digital, textual, graphical or written formats.
|
||||
any other purpose including publishing the images, the project files or the content in the images in any form either digital, non-digital, textual, graphical or written formats.
|
||||
You are allowed to share the links to the repository or the website roadmap.sh but not
|
||||
the content for any sort of usage that involves the content of this repository taken out
|
||||
of the repository and be shared from any other medium including but not limited to blog
|
||||
@@ -9,7 +8,7 @@ posts, articles, newsletters, you must get prior consent from the understated. T
|
||||
conditions do not apply to the readonly GitHub forks created using the Fork button on
|
||||
GitHub with the whole purpose of contributing to the project.
|
||||
|
||||
Copyright © 2023 Kamran Ahmed <kamranahmed.se@gmail.com>
|
||||
Copyright © 2017 - Present. Kamran Ahmed <kamranahmed.se@gmail.com>
|
||||
|
||||
Please note that I am really flexible with allowing the usage of the content in this
|
||||
repository. If you reach out to me with a brief detail of why and how you would like
|
||||
|
Reference in New Issue
Block a user