aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Cam Caswell <[email protected]>2022-03-13 16:15:49 -0400
committerGravatar Cam Caswell <[email protected]>2022-03-13 16:15:49 -0400
commit40bb274538b80eacc7e2435391af9a87d90ab23d (patch)
tree76b47d48ea61bac119a5eecd7b37262374919bd9
parentMerge pull request #669 from python-discord/refine-constraint-check (diff)
Preliminary structure
-rw-r--r--pydis_site/apps/content/resources/guides/pydis-guides/contributing.md55
1 files changed, 46 insertions, 9 deletions
diff --git a/pydis_site/apps/content/resources/guides/pydis-guides/contributing.md b/pydis_site/apps/content/resources/guides/pydis-guides/contributing.md
index 4013962c..2f4cce9d 100644
--- a/pydis_site/apps/content/resources/guides/pydis-guides/contributing.md
+++ b/pydis_site/apps/content/resources/guides/pydis-guides/contributing.md
@@ -4,7 +4,7 @@ description: A guide to contributing to our open source projects.
icon: fab fa-github
---
-Our projects on Python Discord are open source and [available on Github](https://github.com/python-discord). If you would like to contribute, consider one of the following projects:
+Our projects on Python Discord are open source and [available on GitHub](https://github.com/python-discord). If you would like to contribute, consider one of the following projects:
<!-- Project cards -->
<div class="columns is-multiline is-centered is-3 is-variable">
@@ -91,14 +91,6 @@ Our projects on Python Discord are open source and [available on Github](https:/
</div>
</div>
-If you don't understand anything or need clarification, feel free to ask any staff member with the **@PyDis Core Developers** role in the server. We're always happy to help!
-
-### Useful Resources
-
-[Guidelines](./contributing-guidelines/) - General guidelines you should follow when contributing to our projects.<br>
-[Style Guide](./style-guide/) - Information regarding the code styles you should follow when working on our projects.<br>
-[Review Guide](../code-reviews-primer/) - A guide to get you started on doing code reviews.
-
## Contributors Community
We are very happy to have many members in our community that contribute to [our open source projects](https://github.com/python-discord/).
Whether it's writing code, reviewing pull requests, or contributing graphics for our events, it’s great to see so many people being motivated to help out.
@@ -114,3 +106,48 @@ As it’s difficult to precisely quantify contributions, we’ve come up with th
- The member has a positive influence in our contributors subcommunity.
The role will be assigned at the discretion of the Admin Team in consultation with the Core Developers Team.
+
+
+# How do I start contributing?
+ Completing these steps will have you ready to make your first contribution. If you've already been using Git or GitHub feel free to skip those steps, but please make sure to read about the PyDis contributing process and ettiquette. If you are here looking for the answer to a specific question, check out the sub-articles in the top right of the page to see a list of our guides.
+
+
+
+### Fork the repo
+ GitHub is a website based on the Git version control system that stores project files in the cloud. The people working on the project can use GitHub as a central place for sending their changes, getting their teammates' changes, and communicating with each other. Forking the repository that you want to work on will create a copy under your own GitHub account. You'll make your changes to this copy, then later we can bring them back to the PyDis repository.
+
+ [Check out our guide on forking a GitHub repo](./forking-repository/)
+
+### Clone the repo
+ Now that you have your own fork you could make changes to it directly on GitHub, but that's not a convenient way to write code. Instead you can use Git to clone the repo to your local machine, commit changes to it there, then push those changes to GitHub.
+
+ [Check out our guide on forking a GitHub repo](./forking-repository/)
+
+### Set up the project
+ You have the source code on your local computer, but how do you actually run it?
+
+ [Sir Lancebot](./sir-lancebot/)
+
+ [Python Bot](./bot/)
+
+ [Site](./site/)
+
+### Ettiquette
+ [Guidelines](./contributing-guidelines/)
+### Read the style guide
+ [Style Guide](./style-guide/)
+
+### Open a pull request
+
+### The review process
+ [Review Guide](../code-reviews-primer/)
+### Create an issue
+
+
+### Learn the basics of Git
+ Git is a *Version Control System*, software for carefully tracking changes to the files in a project. Git allows the same project to be worked on by people in different places. You can make changes to your local code and then distribute those changes to the other people working on the project.
+
+ [Check out these resources to get started using Git](./working-with-git/)
+
+
+If you don't understand anything or need clarification, feel free to ask any staff member with the **@PyDis Core Developers** role in the server. We're always happy to help!