This repository is an open, community-driven collection of roadmaps for skills, domains, and career paths.
Anyone can contribute new roadmaps by following the simple process described below.
This file explains everything you need to know before contributing, including why forking is required, how to contribute safely, how to prepare your roadmap file, and how to raise a pull request.
This project stores all Roadmaps in easy-to-read Markdown files.
They are categorized as:
- Skill roadmaps
- Domain roadmaps
- Career path roadmaps
Each roadmap follows a simple table-based structure.
A sample template is provided for contributors.
Contributions do not go directly into the main branch.
You cannot push or overwrite files directly.
All changes must come through a pull request (PR).
This protects the project from accidental deletion, broken files, or harmful content.
You will contribute through a fork of the repository.
Forking creates your own copy of this repository inside your GitHub account.
Inside your fork, you have full permission to:
- Create files
- Edit files
- Add roadmaps
- Fix existing content
- Make improvements
Once your work is complete, you send a Pull Request to this main repository.
The maintainers will then review and merge your changes.
- Visit the repository on GitHub.
- Click the Fork button at the top right.
- Choose your GitHub account.
- Your own copy of the repository will be created instantly.
You now have full editing rights inside your fork.
Run the following command in your terminal:
git clone https://github.com/<your-username>/path4dsa-roadmaps
Change directory:
cd path4dsa-roadmaps
You are now working inside your local copy.
Before making any changes, create a new branch:
git checkout -b add-new-roadmap
This keeps your changes clean and organized.
-
Go to the correct folder based on your roadmap type:
- roadmaps/skill/
- roadmaps/domain/
- roadmaps/career/
-
Create a new Markdown file, for example:
skill/my-new-skill-roadmap.md -
Copy the template file from here:
Download the template:
https://github.com/Path4Dsa/path4dsa-roadmaps/blob/main/sample-roadmap-template_for_download.md
-
Paste the template content into your new file.
-
Fill all required sections:
- Metadata
- Table
- Extra resources (optional)
Make sure your file follows the format exactly.
After you finish editing:
git add .
git commit -m "Add new roadmap: <roadmap name>"
git push origin add-new-roadmap
Your changes are now available on your forked repository.
- Visit your fork on GitHub.
- GitHub will show a banner: Compare & Pull Request.
- Click the button.
- Choose the target repository:
Path4Dsa/path4dsa-roadmaps - Select the branch:
main - Add a clear title and description.
- Submit the Pull Request.
Admin will review it shortly.
- Admin will check your file formatting.
- They may request small changes if something is missing.
- Once approved, your roadmap will be merged into the main repository.
- Your name will be listed in the contributor list.
Your contribution becomes part of the Path4DSA ecosystem.
Contributors must use this file:
Link to download:
https://github.com/Path4Dsa/path4dsa-roadmaps/blob/main/sample-roadmap-template_for_download.md
Download it, fill all sections, and use it as your roadmap structure.
When contributing your roadmap:
- Edit your new roadmap file only
- Do not modify this README file
- Do not modify existing roadmaps unless you are fixing an issue
- Follow the exact table format
- Use one docs link per topic
- Extra resources are optional
This ensures consistency across the project.
This README exists to guide you.
If you are contributing, simply follow each step carefully, use the provided template, and create a Pull Request.
Your contribution will help thousands of learners and developers in the Path4DSA community.
Thank you for contributing with ❤️ Sai Krishna