open-sauced / intro

Empowering Your Open Source Journey: From First Contribution to Project Leadership
https://opensauced.pizza/learn
Other
534 stars 108 forks source link

Docs: Reorganize the "Tools to be Successful" chapter to make it flow #240

Open adiati98 opened 2 hours ago

adiati98 commented 2 hours ago

Description

In the "Tools to be Successful" chapter, we have this structure of sections:

- GitHub & Git
   - Introduction to Git
   - Introduction to GitHub
   - Getting Started with Git and GitHub
- VS Code

The "Getting Started with Git and GitHub" section starts with:

To get started with Git and GitHub, follow these steps:

There are instructions to setup Git, but no instruction to sign-up for GitHub.

This section has a subsection of "Practicing Contributing with VS Code" which content a tutorial to create and clone a repo, make changes, and push them to GitHub.

However, the section "VS Code" is right after this subsection. So, it doesn't make sense to practice on VS Code before explaining it.

Suggested Solution

adiati98 commented 2 hours ago

@BekahHW I need your thought on this, also, if we want the docs team to work on it or open it for external contributors. Thanks.