First, we need to download or clone
as it's called in git speak
, this repository.
For more details, follow the instructions in the GitHub Docs.
- Go to github.com/desktop/desktop-markdown-training
- Click
<> Code
- Click
Open with GitHub Desktop
- When GitHub Desktop opens, click
Clone
- In the top navigation bar, click
Current Branch: main
- Click on the
Branches
tab if you aren't already there - Click on
New Branch
- Name your branch:
githubhandle-contribution
- Now you are on you're new branch! 🎉
- Click
Publish Branch
to save your branch to github.com - Click on
Open the repository page on GitHub in your browser
and see that our branch to available for everyone - Click
main
in the repository page on github.com to see the list of all branches
- From within your branch, click
Open the repository in your external editor
- On the left navigation bar, click the
contributions
folder - Then select the new file icon
- type
githubhandle.md
- Click on the file you just created
- Type
# @githubhandle's contribution!
- Press
command
+shift
+v
to show a preview of your markdown file - In the top navigation bar, click
View
thenEditor Layout
thenTwo Columns
- Drag the tab that starts with
Preview
over to the second column. - 🎉 Now we can see our updates as we type them!
- Open GitHub Desktop
- See that our changes are visible
- At the bottom left, type a commit message title, such as
@githubhandle's first commit!
- Click
Commit to yourbranchname
- And we've made our first commit! 🥳
- Click
Push origin
to save our changes on github.com - Click
Create Pull Request
- This will take you to github.com
- Answer the first question in the pull request template -- and use markdown if you can! (Don't worry, though, we will play with a lot more)
- Click on the arrow next to Create pull request
- Select
Create draft pull request
- Click
Create draft pull request
- 🎉 Tada! Your draft PR has been created!
2.5. ➡️ NEXT: Fun with Markdown
Now for the fun stuff! Let's start learning and playing with markdown!