diff --git a/doc/topics/git/get_started.md b/doc/topics/git/get_started.md index d5a4f015d7bf6bfbb3b34c6766af16e02cf5a5d5..94926671d499b7593a0b7f586610c429509d1663 100644 --- a/doc/topics/git/get_started.md +++ b/doc/topics/git/get_started.md @@ -21,7 +21,7 @@ Learning Git is part of a larger workflow: A Git repository is essentially a directory that contains all the files, folders, and version history of a project. -It serves as a central hub where you can store, manage, and share your code or content. +It serves as a central hub to store, manage, and share your code. When you initialize a Git repository or clone an existing one, Git creates a hidden directory called `.git` in the project directory. @@ -83,7 +83,15 @@ For more information, see: - [Tutorial: Make your first Git commit](../../tutorials/make_first_git_commit/index.md) - [Forks](../../user/project/repository/forking_workflow.md) -## Step 4: Familiarize yourself with Git commands +## Step 4: Install Git + +Before you start using Git commands and contributing to GitLab projects, you must download +and install the Git client on your computer. The installation process varies depending on +your operating system. + +For information on how to install Git, see [Install Git](how_to_install_git/index.md). + +## Step 5: Familiarize yourself with Git commands To work with Git from the command line, you need to use various Git commands. Some of the most commonly used commands include: @@ -96,13 +104,30 @@ Some of the most commonly used commands include: - `git push`: Push local commits to the remote repository - `git pull`: Fetch changes from the remote repository and merge them into your local branch -For more information, see: +For more comprehensive information and detailed explanations, +see [Command Git commands](commands.md) guide. + +<!--- Use this section when the [Generate an SSH key pair](../user/ssh.md) page is added to the navigation -- [Command line Git](commands.md) +### Use SSH with Git -## Step 5: Practice using Git +When you work with remote repositories, you should use SSH for secure communication. + +GitLab uses the SSH protocol to securely communicate with Git. +When you use SSH keys to authenticate to the GitLab remote server, +you don't need to supply your username and password each time. + +To learn how to generate and add SSH keys to your GitLab account, +see [Generate an SSH key pair](../user/ssh.md). +--> + +## Step 6: Practice using Git The best way to learn Git is by using it in practice. Create a test project, experiment with different commands, and try out various workflows. GitLab provides a web-based interface for many Git operations, -but it's also useful to understand how to use Git from the command line. +but it is also used to understand how to use Git from the command line. + +For a hands-on approach to learning Git commands, see the [Tutorial: Make your first Git commit](../../tutorials/make_first_git_commit/index.md). + +For other helpful resources, see [Tutorials: Learn Git](../../tutorials/learn_git.md).