Skip to content
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

[Track 0/8] GitHub setup #1

Open
taki-tiler bot opened this issue Nov 4, 2024 · 6 comments
Open

[Track 0/8] GitHub setup #1

taki-tiler bot opened this issue Nov 4, 2024 · 6 comments

Comments

@taki-tiler
Copy link

taki-tiler bot commented Nov 4, 2024

Taqtile - Onboard

Welcome to the Taqtile onboard. The main goals of this onboard are:

  1. Learn the basics about some concepts by building your own application/website
  2. Get you ready for a real project by presenting some of our tech stack and best practices

Step 1/3 - Warming up - Mastering the Basics

Ok! Your very first tasks are to clone this repository into your own account and create the README.md file.

But before moving on, let's be sure you know all the basics we use daily here.

First, we use git... a lot. If you don't feel confident in your skills using git, here are some recommendations:

If you don't have it already, we recommend you to install the GitLens VSCode extension. It's going to help you a lot with git by adding an extra view on activity bar (the icons on the left side).

GitLens

It will help you to check the modified files, as well as the changes on each of them.

Even though this extension has some tools to perform git commands, we highly encourage you to use the terminal, and use the extension as a visual guide to your changes.


At the end of every task of this onboard, comment the word Finish on the issue to receive your next task (you can try reloading the page if it's taking too long).
You can also comment the word next, in case you had to skip the current task.

If you face any problem with the onboard, you can ask your tutor for help.

@henriquegeribello
Copy link
Collaborator

Finish

Copy link
Author

taki-tiler bot commented Nov 4, 2024

Step 2/3 - Clone this repository

Follow the steps below in order to clone (download) this repository:

  • Login to GitHub (if you don't have an account, create one here)
  • Go to this repository root page
  • Click on Code green button
  • Copy the repository link and type the following command in Terminal:
$ git clone repository_link

When you're done, the git will clone (download) the entire project into the folder you're running the terminal.

@henriquegeribello
Copy link
Collaborator

Finish

Copy link
Author

taki-tiler bot commented Nov 4, 2024

Step 3/3 - Git Flow

Before continuing, it's important to be familiar with our branch model and a some git tricks.

Branch model

When working in teams, it's crucial to coordinate the parallel work of all team members.

In order to improve our workflow, a few years ago, we've adopted the Vincent Driessen's branch model described here. So let's use this same branch model during our onboard.

Git Flow

git-flow is a tool that helps to follow Vincent Driessen's branch model. You can use it though it's not necessary.

Our conventions

There are a few conventions we use here and it's important for you to be aware of them:

  1. Branches that introduce new features are:
  • prepended with feature/ i.e. feature/login-screen
  • should have meaningful names - they should give good hints about what modifications to the system they have
  • should not have your name on it
  1. Branches that fix a bug are:
  • prepended with bugfix/ i.e. bugfix/login-screen-animation

@henriquegeribello
Copy link
Collaborator

Finish

Copy link
Author

taki-tiler bot commented Nov 4, 2024

Click here for your next track

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant