Add contribution guide for writing roadmap
This commit is contained in:
@ -1 +1,34 @@
|
||||
# Submitting a new roadmap
|
||||
|
||||
First of all thank you for considering to contribute to this project. It wouldn't have been possible for us to keep it live without your contributions 🙏
|
||||
|
||||
> This process will be automated soon. Follow the steps listed below in order to add a new roadmap for now
|
||||
|
||||
* Fork this repository
|
||||
* If you haven't contributed to this project before then create your author profile
|
||||
* Open the file [authors.json](../content/authors.json)
|
||||
* Put your preferred `username`
|
||||
* Put a profile picture in [authors directory](../public/authors) with the username
|
||||
* Create a new directory for the roadmap inside the [roadmaps directory](../content/roadmaps) by following the below steps:
|
||||
* Directory name must be `kebab-cased` and prefixed with the incremental number e.g. `6-java-developer`
|
||||
* Create a markdown file `6-java-developer/0-About/0-Summary.md` inside this directory and write the article detailing the steps required for this path. It doesn't have to be graphic like the other roadmaps; just focus on writing a detailed but approachable textual guide.
|
||||
* Create a file `meta.json` inside the roadmap directory with the content below:
|
||||
```json
|
||||
{
|
||||
"title": "Java Developer",
|
||||
"description": "Step by step guide to becoming a modern Java Developer",
|
||||
"featuredDescription": "Step by step guide to becoming a modern Java Developer in 2020",
|
||||
"author": {
|
||||
"name": "Your Name",
|
||||
"url": "https://twitter.com/twitter"
|
||||
},
|
||||
"featured": false,
|
||||
"detailed": false,
|
||||
"versions": []
|
||||
}
|
||||
```
|
||||
* Once done, run the below command:
|
||||
```shell
|
||||
yarn meta:roadmaps
|
||||
```
|
||||
* Commit, push and open a pull request
|
||||
|
@ -24,10 +24,10 @@ const RoadmapsList = () => (
|
||||
title={PageTitle}
|
||||
subtitle={PageDescription}>
|
||||
<BadgesList className="mt-4">
|
||||
<BadgeLink href={`${siteConfig.url.issue}?title=[RequestRoadmap] - Title Here`} target="_blank">
|
||||
<BadgeLink href={siteConfig.url.addRoadmap} target="_blank">
|
||||
<SecondaryBadge>
|
||||
<FontAwesomeIcon icon={faCodeBranch}/>
|
||||
Request a Roadmap
|
||||
Write a Roadmap
|
||||
</SecondaryBadge>
|
||||
</BadgeLink>
|
||||
<BadgeLink href="/signup">
|
||||
|
Reference in New Issue
Block a user