-
Notifications
You must be signed in to change notification settings - Fork 4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[Feb 4 merge] Review GitHub lessons 0-3 #105
base: rm-gh-0-3
Are you sure you want to change the base?
Conversation
### Answer these questions | ||
|
||
* Does the repository accept contributions? If so, what types of contributions are accepted? | ||
* Does the repository use specific code or text formatting standards or liters? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think there is a typo: "liters" --> "linters"
|
||
In this lesson you will create or comment on an issue that you'd like to fix in GitHub repository that you don't own. | ||
|
||
:::{admonition} Activity: Create (or find) an issue for a bug that you'd like to fix |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there a reason you don't just direct the user to open an issue to fix a specific error in the code or documentation? If the purpose is mainly to walk people through the process of opening an issue, it seems unnecessary to ask the user to look for something to fix in a dummy repository. This confused me initially.
* [Make your changes on a new branch in your fork.](4-edit-commit-files) | ||
* [Submit a pull request](5-pull-request) with your updates. | ||
|
||
A gentle nudge is ok if maintainers don't respond after a few weeks. That might look something like this: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This seems to repeat the content in lines 79–81.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @lwasser , I added a few inline comments to highlight a few minor issues. I stopped before reviewing 3-fork-repo.md
. This is all very helpful for a newcomer like me!
These lessons are already online to meet a deadline. However, I wanted to make sure we could have a normal review process on them!
Therefore, this is a hacked branch that allowed me to create a pr with the 4 files in the lessons that can be reviewed as "new" files.
If you want to see the lessons rendered, you can either check Ci OR you can have a look here for context. these lessons do have some images and we can always add more.
I'm looking for feedback on how the lessons read, The goal is to use them in our sprints and to make it easier for people to make first contributions to open source (which we normally have happen in our sprint events!).