Skip to content

Commit 9794014

Browse files
authored
Create CONTRIBUTION.md
1 parent 47702d5 commit 9794014

File tree

1 file changed

+104
-0
lines changed

1 file changed

+104
-0
lines changed

CONTRIBUTION.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
Here’s your `CONTRIBUTION.md` file in the correct Markdown format, including your username:
2+
3+
---
4+
5+
# Contribution Guidelines for Django Projects for Beginners
6+
7+
[![Django](https://img.shields.io/badge/Python-Django-green)](https://www.djangoproject.com/)
8+
[![PyVersion](https://img.shields.io/pypi/pyversions/djangocms-installer.svg?style=flat-square)](https://pypi.python.org/pypi/djangocms-installer)
9+
10+
Welcome to **Django-Projects-for-Beginners**! We are excited to see your interest in contributing to this beginner-friendly collection of Django projects. Whether you are just starting with Django or looking to expand your knowledge, your contributions are valuable.
11+
12+
## Introduction
13+
14+
**Django-Projects-for-Beginners** is a collaborative repository aimed at helping developers learn the fundamentals of Django web development. Each project in this collection covers essential concepts such as models, views, templates, and forms. This makes it an excellent resource for those new to Django and web development in general.
15+
16+
If you're a beginner, feel free to explore the projects and contribute your own Django applications.
17+
18+
## What to Contribute 🛠️
19+
20+
Here are some ways you can contribute:
21+
22+
- **Create a Django Project**: Examples include a blog, a to-do list app, or an e-commerce website.
23+
- **Follow Django Best Practices**: Ensure your project follows Django's structure and includes a `requirements.txt` file listing necessary dependencies.
24+
- **Only Use Django**: Please do not use any other framework for the project.
25+
26+
For more information, refer to the official [Django documentation](https://docs.djangoproject.com/en/stable/).
27+
28+
## When to Use Django?
29+
30+
- **Quick Development**: Django’s pre-built tools and automatic admin interface speed up development.
31+
- **Scalability**: Django is great for projects that may grow in complexity or size.
32+
- **Security**: Django includes robust security features out of the box, ideal for handling sensitive data.
33+
34+
## How to Contribute 💻
35+
36+
### 1. Fork the Repository
37+
38+
- Click the "Fork" button at the top of this repository page to create your own copy in your GitHub account.
39+
40+
### 2. Clone the Repository
41+
42+
- Clone your forked repository to your local machine using this command:
43+
```bash
44+
git clone https://github.com/ianshulx/Django-Projects-for-beginners.git
45+
```
46+
47+
### 3. Navigate to the Project Directory
48+
49+
- Use the following command to navigate to the project directory:
50+
```bash
51+
cd Django-Projects-for-beginners
52+
```
53+
54+
### 4. Create a New Branch
55+
56+
- Create a new branch for your contribution to keep it organized:
57+
```bash
58+
git checkout -b my-new-branch
59+
```
60+
61+
### 5. Add Your Django Project
62+
63+
- Add your Django project folder to the repository, ensuring it follows the standard Django project structure.
64+
- Include a `requirements.txt` file listing all necessary dependencies for your project.
65+
66+
### 6. Stage Your Changes
67+
68+
- Stage your changes using the following command:
69+
```bash
70+
git add .
71+
```
72+
73+
### 7. Commit Your Changes
74+
75+
- Commit your changes with a relevant message:
76+
```bash
77+
git commit -m "Added a new Django project: Project Name"
78+
```
79+
80+
### 8. Push Your Changes
81+
82+
- Push your changes to the new branch in your forked repository:
83+
```bash
84+
git push origin my-new-branch
85+
```
86+
87+
### 9. Create a Pull Request
88+
89+
- Head over to your forked repository on GitHub and click the “Compare & pull request” button to submit your changes.
90+
- Write a clear description of your contribution, mentioning what you’ve added or changed.
91+
92+
## Hacktoberfest Participation 🎃
93+
94+
If you're participating in Hacktoberfest, make sure your contributions are meaningful and follow the repository's structure. Don't forget to label your PR with `hacktoberfest-accepted` to ensure it counts!
95+
96+
## Resources 📖
97+
98+
- [Django Documentation](https://docs.djangoproject.com/en/stable/)
99+
- [Hacktoberfest Official Site](https://hacktoberfest.com/)
100+
101+
Thank you for contributing to **Django-Projects-for-Beginners**! We look forward to reviewing your projects and pull requests.
102+
103+
---
104+

0 commit comments

Comments
 (0)