diff --git a/doc/gitlab_basics/README.md b/doc/gitlab_basics/README.md new file mode 100644 index 0000000000000000000000000000000000000000..c434e0146e34d4be35eae6efd9696dfee9d6cf88 --- /dev/null +++ b/doc/gitlab_basics/README.md @@ -0,0 +1,7 @@ +# GitLab basics + +Step-by-step guides on the basics of working with Git and GitLab. + +* [Start using Git on the commandline](start_using_git.md) + + diff --git a/doc/gitlab_basics/basicsimages/add_new_merge_request.png b/doc/gitlab_basics/basicsimages/add_new_merge_request.png new file mode 100644 index 0000000000000000000000000000000000000000..9d93b217a59c00af16acd6b2f76024f2aea42e1a Binary files /dev/null and b/doc/gitlab_basics/basicsimages/add_new_merge_request.png differ diff --git a/doc/gitlab_basics/basicsimages/add_sshkey.png b/doc/gitlab_basics/basicsimages/add_sshkey.png new file mode 100644 index 0000000000000000000000000000000000000000..2dede97aa405b5ef004bea3f8841d591518c3795 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/add_sshkey.png differ diff --git a/doc/gitlab_basics/basicsimages/branch_info.png b/doc/gitlab_basics/basicsimages/branch_info.png new file mode 100644 index 0000000000000000000000000000000000000000..c5e38b552a5fd55473adac81c65f4110eee94f18 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/branch_info.png differ diff --git a/doc/gitlab_basics/basicsimages/branch_name.png b/doc/gitlab_basics/basicsimages/branch_name.png new file mode 100644 index 0000000000000000000000000000000000000000..06e77f5eea994fb94bc3d4aec8159ec9322d6465 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/branch_name.png differ diff --git a/doc/gitlab_basics/basicsimages/branches.png b/doc/gitlab_basics/basicsimages/branches.png new file mode 100644 index 0000000000000000000000000000000000000000..c18fa83b9682bdb4179a5ae628a02c8e3a181883 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/branches.png differ diff --git a/doc/gitlab_basics/basicsimages/commit_changes.png b/doc/gitlab_basics/basicsimages/commit_changes.png new file mode 100644 index 0000000000000000000000000000000000000000..81588336f371437533b6dd6ddc87b953006ba5b4 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/commit_changes.png differ diff --git a/doc/gitlab_basics/basicsimages/commit_message.png b/doc/gitlab_basics/basicsimages/commit_message.png new file mode 100644 index 0000000000000000000000000000000000000000..0df2c32653c4d861fcd7aa5decf9498e8b8080c5 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/commit_message.png differ diff --git a/doc/gitlab_basics/basicsimages/commits.png b/doc/gitlab_basics/basicsimages/commits.png new file mode 100644 index 0000000000000000000000000000000000000000..7e6065390776e304b5bf3013b9eb185e949a0d41 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/commits.png differ diff --git a/doc/gitlab_basics/basicsimages/compare_braches.png b/doc/gitlab_basics/basicsimages/compare_braches.png new file mode 100644 index 0000000000000000000000000000000000000000..7eebaed9075079d18cd956b19beea7ff030c9c79 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/compare_braches.png differ diff --git a/doc/gitlab_basics/basicsimages/create_file.png b/doc/gitlab_basics/basicsimages/create_file.png new file mode 100644 index 0000000000000000000000000000000000000000..688e355cca267e467043e0467fb7a78390677b64 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/create_file.png differ diff --git a/doc/gitlab_basics/basicsimages/create_group.png b/doc/gitlab_basics/basicsimages/create_group.png new file mode 100644 index 0000000000000000000000000000000000000000..57da898abdc811d8a7a708c706a66073c9f204af Binary files /dev/null and b/doc/gitlab_basics/basicsimages/create_group.png differ diff --git a/doc/gitlab_basics/basicsimages/edit_file.png b/doc/gitlab_basics/basicsimages/edit_file.png new file mode 100644 index 0000000000000000000000000000000000000000..afa6876010872a86de497c8ccc235879746a8bb3 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/edit_file.png differ diff --git a/doc/gitlab_basics/basicsimages/file_located.png b/doc/gitlab_basics/basicsimages/file_located.png new file mode 100644 index 0000000000000000000000000000000000000000..1def489d16b2e82835bbe6598da4f19407c3fc30 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/file_located.png differ diff --git a/doc/gitlab_basics/basicsimages/file_name.png b/doc/gitlab_basics/basicsimages/file_name.png new file mode 100644 index 0000000000000000000000000000000000000000..9ac2f1c355ff8186d1e7462bcd3f52d3a811be5f Binary files /dev/null and b/doc/gitlab_basics/basicsimages/file_name.png differ diff --git a/doc/gitlab_basics/basicsimages/find_file.png b/doc/gitlab_basics/basicsimages/find_file.png new file mode 100644 index 0000000000000000000000000000000000000000..98639149a39353cf8aab8a56ce4da565a2cd76fc Binary files /dev/null and b/doc/gitlab_basics/basicsimages/find_file.png differ diff --git a/doc/gitlab_basics/basicsimages/find_group.png b/doc/gitlab_basics/basicsimages/find_group.png new file mode 100644 index 0000000000000000000000000000000000000000..5ac33c7e9539bcdc49f3dc62838e63934492afbc Binary files /dev/null and b/doc/gitlab_basics/basicsimages/find_group.png differ diff --git a/doc/gitlab_basics/basicsimages/fork.png b/doc/gitlab_basics/basicsimages/fork.png new file mode 100644 index 0000000000000000000000000000000000000000..b1f949386138367ccfe1fd1fe6ada50d4e52db47 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/fork.png differ diff --git a/doc/gitlab_basics/basicsimages/group_info.png b/doc/gitlab_basics/basicsimages/group_info.png new file mode 100644 index 0000000000000000000000000000000000000000..e78d84e4d800876761baff4ef29d75b901763d6c Binary files /dev/null and b/doc/gitlab_basics/basicsimages/group_info.png differ diff --git a/doc/gitlab_basics/basicsimages/groups.png b/doc/gitlab_basics/basicsimages/groups.png new file mode 100644 index 0000000000000000000000000000000000000000..b8104343afa096a1fd1cf62a6cd852aa23f7a8a1 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/groups.png differ diff --git a/doc/gitlab_basics/basicsimages/https.png b/doc/gitlab_basics/basicsimages/https.png new file mode 100644 index 0000000000000000000000000000000000000000..2a31b4cf751009bd7838cb9f1729c8b1596001dc Binary files /dev/null and b/doc/gitlab_basics/basicsimages/https.png differ diff --git a/doc/gitlab_basics/basicsimages/image_file.png b/doc/gitlab_basics/basicsimages/image_file.png new file mode 100644 index 0000000000000000000000000000000000000000..1061d9c5082d2994acfd49b1fa30b8ba6bc7ec95 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/image_file.png differ diff --git a/doc/gitlab_basics/basicsimages/issue_title.png b/doc/gitlab_basics/basicsimages/issue_title.png new file mode 100644 index 0000000000000000000000000000000000000000..7b69c705392a9b64ed851d4c15638554ae31f2aa Binary files /dev/null and b/doc/gitlab_basics/basicsimages/issue_title.png differ diff --git a/doc/gitlab_basics/basicsimages/issues.png b/doc/gitlab_basics/basicsimages/issues.png new file mode 100644 index 0000000000000000000000000000000000000000..9354d05319e6e994246049e7d86c0d877183bf5a Binary files /dev/null and b/doc/gitlab_basics/basicsimages/issues.png differ diff --git a/doc/gitlab_basics/basicsimages/key.png b/doc/gitlab_basics/basicsimages/key.png new file mode 100644 index 0000000000000000000000000000000000000000..321805cda9833ace5a1e94fe5ce01e7967e82486 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/key.png differ diff --git a/doc/gitlab_basics/basicsimages/merge_requests.png b/doc/gitlab_basics/basicsimages/merge_requests.png new file mode 100644 index 0000000000000000000000000000000000000000..7601d40de478c6573fa165936f0d23cf0cebf87f Binary files /dev/null and b/doc/gitlab_basics/basicsimages/merge_requests.png differ diff --git a/doc/gitlab_basics/basicsimages/new_issue.png b/doc/gitlab_basics/basicsimages/new_issue.png new file mode 100644 index 0000000000000000000000000000000000000000..94e7503dd8b4784ed4d28e99e2d279f6a1eebb35 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/new_issue.png differ diff --git a/doc/gitlab_basics/basicsimages/new_merge_request.png b/doc/gitlab_basics/basicsimages/new_merge_request.png new file mode 100644 index 0000000000000000000000000000000000000000..9120d2b1ab1a31bf149f196c5cf230c2d2b83f9f Binary files /dev/null and b/doc/gitlab_basics/basicsimages/new_merge_request.png differ diff --git a/doc/gitlab_basics/basicsimages/new_project.png b/doc/gitlab_basics/basicsimages/new_project.png new file mode 100644 index 0000000000000000000000000000000000000000..ac255270a66e058bec3b5ee4ae78f61fef0c4aa6 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/new_project.png differ diff --git a/doc/gitlab_basics/basicsimages/newbranch.png b/doc/gitlab_basics/basicsimages/newbranch.png new file mode 100644 index 0000000000000000000000000000000000000000..da1a6b604ea5bc657c3d1a9b2841da2ca824a88c Binary files /dev/null and b/doc/gitlab_basics/basicsimages/newbranch.png differ diff --git a/doc/gitlab_basics/basicsimages/paste_sshkey.png b/doc/gitlab_basics/basicsimages/paste_sshkey.png new file mode 100644 index 0000000000000000000000000000000000000000..9880ddfead1f3cd52fa4c559716c5fa6e9a4247e Binary files /dev/null and b/doc/gitlab_basics/basicsimages/paste_sshkey.png differ diff --git a/doc/gitlab_basics/basicsimages/profile_settings.png b/doc/gitlab_basics/basicsimages/profile_settings.png new file mode 100644 index 0000000000000000000000000000000000000000..5f2e7a7e10cd762c7f373155714fb2c8264b37a4 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/profile_settings.png differ diff --git a/doc/gitlab_basics/basicsimages/project_info.png b/doc/gitlab_basics/basicsimages/project_info.png new file mode 100644 index 0000000000000000000000000000000000000000..6c06ff351facdae030439a883ac95834dd1287cd Binary files /dev/null and b/doc/gitlab_basics/basicsimages/project_info.png differ diff --git a/doc/gitlab_basics/basicsimages/public_file_link.png b/doc/gitlab_basics/basicsimages/public_file_link.png new file mode 100644 index 0000000000000000000000000000000000000000..1a60a3d880a4e9d7ded0e8b9d74ad445808c12ce Binary files /dev/null and b/doc/gitlab_basics/basicsimages/public_file_link.png differ diff --git a/doc/gitlab_basics/basicsimages/select_branch.png b/doc/gitlab_basics/basicsimages/select_branch.png new file mode 100644 index 0000000000000000000000000000000000000000..3475b2df57623d4bf492cf9e832df64b22ee3926 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/select_branch.png differ diff --git a/doc/gitlab_basics/basicsimages/select_project.png b/doc/gitlab_basics/basicsimages/select_project.png new file mode 100644 index 0000000000000000000000000000000000000000..6d5aa4391240eae714520cf2333a63318158fef2 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/select_project.png differ diff --git a/doc/gitlab_basics/basicsimages/settings.png b/doc/gitlab_basics/basicsimages/settings.png new file mode 100644 index 0000000000000000000000000000000000000000..9bf9c5a0d39eb2401b77ac704f198ac4aca9f5fe Binary files /dev/null and b/doc/gitlab_basics/basicsimages/settings.png differ diff --git a/doc/gitlab_basics/basicsimages/shh_keys.png b/doc/gitlab_basics/basicsimages/shh_keys.png new file mode 100644 index 0000000000000000000000000000000000000000..d7ef4dafe77d92a10ddf2d58ef4945bb0aa6c022 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/shh_keys.png differ diff --git a/doc/gitlab_basics/basicsimages/submit_new_issue.png b/doc/gitlab_basics/basicsimages/submit_new_issue.png new file mode 100644 index 0000000000000000000000000000000000000000..1894441708529a7a429090c1c86f5755b2861563 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/submit_new_issue.png differ diff --git a/doc/gitlab_basics/basicsimages/title_description_mr.png b/doc/gitlab_basics/basicsimages/title_description_mr.png new file mode 100644 index 0000000000000000000000000000000000000000..e08eb628414e102046b086dc31c3015c616395b9 Binary files /dev/null and b/doc/gitlab_basics/basicsimages/title_description_mr.png differ diff --git a/doc/gitlab_basics/basicsimages/white_space.png b/doc/gitlab_basics/basicsimages/white_space.png new file mode 100644 index 0000000000000000000000000000000000000000..6363a09360e87eb6d2b6ef7eb298848a7565b16b Binary files /dev/null and b/doc/gitlab_basics/basicsimages/white_space.png differ diff --git a/doc/gitlab_basics/start_using_git.md b/doc/gitlab_basics/start_using_git.md new file mode 100644 index 0000000000000000000000000000000000000000..f01a2f77eecdfe6c84dae6f28f49022a9f16a7c5 --- /dev/null +++ b/doc/gitlab_basics/start_using_git.md @@ -0,0 +1,67 @@ +# Start using Git on the commandline + +If you want to start using a Git and GitLab, make sure that you have created an account on [gitlab.com](https://about.gitlab.com/) + +## Open a shell + +* Depending on your operating system, find the shell of your preference. Here are some suggestions + +- [Terminal](http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line) on Mac OSX + +- [GitBash](https://msysgit.github.io) on Windows + +- [Linux Terminal](http://www.howtogeek.com/140679/beginner-geek-how-to-start-using-the-linux-terminal/) on Linux + +## Check if Git has already been installed + +* Git is usually preinstalled on Mac and Linux + +* Type the following command and then press enter + +``` +git --version +``` + +* You should receive a message that will tell you which Git version you have in your computer. If you don’t receive a "Git version" message, it means that you need to [download Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) + +* If Git doesn't automatically download, there's an option on the website to [download manually](https://git-scm.com/downloads). Then follow the steps on the installation window + +* After you finished installing, open a new shell and type "git --version" again to verify that it was correctly installed + +## Add your Git username and set your email + +* It is important because every Git commit that you create will use this information + +* On your shell, type the following command to add your username + +``` +git config --global user.name ADD YOUR USERNAME +``` + +* Then verify that you have the correct username + +``` +git config --global user.name +``` + +* To set your email address, type the following command + +``` +git config --global user.email ADD YOUR EMAIL +``` + +* To verify that you entered your email correctly, type + +``` +git config --global user.email +``` + +* You'll need to do this only once because you are using the "--global" option. It tells Git to always use this information for anything you do on that system. If you want to override this with a different username or email address for specific projects, you can run the command without the "--global" option when you’re in that project + +## Check your information + +* To view the information that you entered, type + +``` +git config --global --list +```