Skip to content

Commit c043c2c

Browse files
committed
rewrite: social cues added throughout
1 parent caca784 commit c043c2c

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

github-git/your-first-contribution.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,11 @@ og:image:alt: An image that shows the steps for contributing to open source on G
2626

2727
:::{admonition} What you will learn
2828

29-
Completing this activity will give you the technical and social skills needed to contribute to an open source GitHub
30-
repository successfully. You will use the [pyOpenSci example GitHub repository](https://github.com/pyOpenSci/pyos-demo-package-contribute) to practice making contributions.
29+
Completing this set of activities will give you the technical and social skills needed to collaborate and contribute to an open source GitHub
30+
repository. You will use the [pyOpenSci example GitHub repository](https://github.com/pyOpenSci/pyos-demo-package-contribute) as a safe space to practice making contributions.
3131
:::
3232

33-
Here, you will learn how to collaborate on code and documentation using GitHub. After completing the activities below, you will be able to contribute to a GitHub repository you don't own with confidence.
34-
35-
This page introduces all of the steps and walks you through each one. Each activity has a related lesson that will help you navigate and understand the social and technical elements associated with the process.
33+
This page introduces all of the steps and walks you through each one. Each activity below has a lesson that will help you understand the social and technical elements of the contribution process.
3634

3735
## An overview of the collaborative GitHub workflow
3836

@@ -48,7 +46,9 @@ The steps for making your first contribution to an open source repo. In this les
4846

4947
First, identify and get to know the repository you want to contribute to. Use the [pyOpenSci learning repository](https://github.com/pyOpenSci/pyos-demo-package-contribute) to test out the process.
5048

51-
[Getting to know that repository](get-to-know-repo) will save you and the maintainers time when you make your first contribution. Ideally, the repository has documented the types of contributions they welcome and how they want contributions to happen. Reading through that documentation first will help you get started quickly and minimize the questions you ask the maintainer team. Most often, the best place for a new contributor to start, regardless of their experience contributing, is the [contributing guide](https://www.pyopensci.org/python-package-guide/documentation/repository-files/contributing-file.html) and the [README file](https://www.pyopensci.org/python-package-guide/documentation/repository-files/readme-file-best-practices.html).
49+
[Getting to know that repository](get-to-know-repo) will save you and the maintainers time when you make your first contribution. You can think about like doing some research on a blog post before sitting down and writing it.
50+
51+
Ideally, the repository you have chosen has documented the types of contributions they welcome and what process they want contributors to follow. Reading through that documentation first will help you get started quickly and minimize the questions you ask the maintainer team. Most often, the best place for a new contributor to start, regardless of their experience contributing, is the [contributing guide](https://www.pyopensci.org/python-package-guide/documentation/repository-files/contributing-file.html) and the [README file](https://www.pyopensci.org/python-package-guide/documentation/repository-files/readme-file-best-practices.html).
5252

5353
:::{button-link} get-to-know-repo.html
5454
:color: primary
@@ -61,7 +61,7 @@ First, identify and get to know the repository you want to contribute to. Use th
6161

6262
Open a new browser tab after reading through the [get-to-know a repo lesson](get-to-know-repo). Navigate to [https://github.com/pyOpenSci/pyos-demo-package-contribute/](https://github.com/pyOpenSci/pyos-demo-package-contribute/).
6363

64-
* Check out the [README](https://github.com/pyOpenSci/pyos-demo-package-contribute/blob/main/README.md) and [CONTRIBUTING](https://github.com/pyOpenSci/pyos-demo-package-contribute/blob/main/CONTRIBUTING.md) files.
64+
* Review the [README](https://github.com/pyOpenSci/pyos-demo-package-contribute/blob/main/README.md) and [CONTRIBUTING](https://github.com/pyOpenSci/pyos-demo-package-contribute/blob/main/CONTRIBUTING.md) files.
6565

6666
**Answer these questions**
6767

0 commit comments

Comments
 (0)