diff options
author | Marcia Ramos <marcia@gitlab.com> | 2019-07-05 11:17:40 +0300 |
---|---|---|
committer | Marcia Ramos <marcia@gitlab.com> | 2019-07-05 11:17:40 +0300 |
commit | 80886b6b72b5372ba33d65b9af56259f9aaadd4b (patch) | |
tree | 741ca1257da69ba8dcc099f917f1f84691a31021 | |
parent | 2fec78ead4ce46b9728be02693b6e50cce740726 (diff) | |
parent | ef66b8db797b63c8207cfa6a21f097ac00ce1731 (diff) |
Merge branch 'docs-workflow-images' into 'master'
Docs: Move gitlab_flow doc images to /img dir
See merge request gitlab-org/gitlab-ce!30389
-rw-r--r-- | doc/workflow/gitlab_flow.md | 35 | ||||
-rw-r--r-- | doc/workflow/img/ci_mr.png (renamed from doc/workflow/ci_mr.png) | bin | 12024 -> 12024 bytes | |||
-rw-r--r-- | doc/workflow/img/close_issue_mr.png (renamed from doc/workflow/close_issue_mr.png) | bin | 42108 -> 42108 bytes | |||
-rw-r--r-- | doc/workflow/img/environment_branches.png (renamed from doc/workflow/environment_branches.png) | bin | 12354 -> 12354 bytes | |||
-rw-r--r-- | doc/workflow/img/four_stages.png (renamed from doc/workflow/four_stages.png) | bin | 7124 -> 7124 bytes | |||
-rw-r--r-- | doc/workflow/img/git_pull.png (renamed from doc/workflow/git_pull.png) | bin | 28701 -> 28701 bytes | |||
-rw-r--r-- | doc/workflow/img/gitdashflow.png (renamed from doc/workflow/gitdashflow.png) | bin | 68177 -> 68177 bytes | |||
-rw-r--r-- | doc/workflow/img/github_flow.png (renamed from doc/workflow/github_flow.png) | bin | 6173 -> 6173 bytes | |||
-rw-r--r-- | doc/workflow/img/gitlab_flow.png (renamed from doc/workflow/gitlab_flow.png) | bin | 47430 -> 47430 bytes | |||
-rw-r--r-- | doc/workflow/img/good_commit.png (renamed from doc/workflow/good_commit.png) | bin | 8740 -> 8740 bytes | |||
-rw-r--r-- | doc/workflow/img/merge_commits.png (renamed from doc/workflow/merge_commits.png) | bin | 7564 -> 7564 bytes | |||
-rw-r--r-- | doc/workflow/img/merge_request.png (renamed from doc/workflow/merge_request.png) | bin | 47225 -> 47225 bytes | |||
-rw-r--r-- | doc/workflow/img/messy_flow.png (renamed from doc/workflow/messy_flow.png) | bin | 11663 -> 11663 bytes | |||
-rw-r--r-- | doc/workflow/img/mr_inline_comments.png (renamed from doc/workflow/mr_inline_comments.png) | bin | 52503 -> 52503 bytes | |||
-rw-r--r-- | doc/workflow/img/production_branch.png (renamed from doc/workflow/production_branch.png) | bin | 7262 -> 7262 bytes | |||
-rw-r--r-- | doc/workflow/img/rebase.png (renamed from doc/workflow/rebase.png) | bin | 28939 -> 28939 bytes | |||
-rw-r--r-- | doc/workflow/img/release_branches.png (renamed from doc/workflow/release_branches.png) | bin | 12736 -> 12736 bytes | |||
-rw-r--r-- | doc/workflow/img/remove_checkbox.png (renamed from doc/workflow/remove_checkbox.png) | bin | 6904 -> 6904 bytes |
18 files changed, 18 insertions, 17 deletions
diff --git a/doc/workflow/gitlab_flow.md b/doc/workflow/gitlab_flow.md index 0cb390e1242..2f365e42cc9 100644 --- a/doc/workflow/gitlab_flow.md +++ b/doc/workflow/gitlab_flow.md @@ -1,7 +1,8 @@ -![GitLab Flow](gitlab_flow.png) # Introduction to GitLab Flow +![GitLab Flow](img/gitlab_flow.png) + Git allows a wide variety of branching strategies and workflows. Because of this, many organizations end up with workflows that are too complicated, not clearly defined, or not integrated with issue tracking systems. Therefore, we propose GitLab flow as a clearly defined set of best practices. @@ -11,7 +12,7 @@ Organizations coming to Git from other version control systems frequently find i This article describes GitLab flow, which integrates the Git workflow with an issue tracking system. It offers a simple, transparent, and effective way to work with Git. -![Four stages (working copy, index, local repo, remote repo) and three steps between them](four_stages.png) +![Four stages (working copy, index, local repo, remote repo) and three steps between them](img/four_stages.png) When converting to Git, you have to get used to the fact that it takes three steps to share a commit with colleagues. Most version control systems have only one step: committing from the working copy to a shared server. @@ -19,7 +20,7 @@ In Git, you add files from the working copy to the staging area. After that, you The third step is pushing to a shared remote repository. After getting used to these three steps, the next challenge is the branching model. -![Multiple long-running branches and merging in all directions](messy_flow.png) +![Multiple long-running branches and merging in all directions](img/messy_flow.png) Since many organizations new to Git have no conventions for how to work with it, their repositories can quickly become messy. The biggest problem is that many long-running branches emerge that all contain part of the changes. @@ -31,7 +32,7 @@ For a video introduction of how this works in GitLab, see [GitLab Flow](https:// ## Git flow and its problems -![Git Flow timeline by Vincent Driessen, used with permission](gitdashflow.png) +![Git Flow timeline by Vincent Driessen, used with permission](img/gitdashflow.png) Git flow was one of the first proposals to use Git branches, and it has received a lot of attention. It suggests a `master` branch and a separate `develop` branch, as well as supporting branches for features, releases, and hotfixes. @@ -54,7 +55,7 @@ For example, many projects do releases but don't need to do hotfixes. ## GitHub flow as a simpler alternative -![Master branch with feature branches merged in](github_flow.png) +![Master branch with feature branches merged in](img/github_flow.png) In reaction to Git flow, GitHub created a simpler alternative. [GitHub flow](https://guides.github.com/introduction/flow/index.html) has only feature branches and a `master` branch. @@ -66,7 +67,7 @@ With GitLab flow, we offer additional guidance for these questions. ## Production branch with GitLab flow -![Master branch and production branch with an arrow that indicates a deployment](production_branch.png) +![Master branch and production branch with an arrow that indicates a deployment](img/production_branch.png) GitHub flow assumes you can deploy to production every time you merge a feature branch. While this is possible in some cases, such as SaaS applications, there are many cases where this is not possible. @@ -82,7 +83,7 @@ This flow prevents the overhead of releasing, tagging, and merging that happens ## Environment branches with GitLab flow -![Multiple branches with the code cascading from one to another](environment_branches.png) +![Multiple branches with the code cascading from one to another](img/environment_branches.png) It might be a good idea to have an environment that is automatically updated to the `master` branch. Only, in this case, the name of this environment might differ from the branch name. @@ -98,7 +99,7 @@ If this is not possible because more manual testing is required, you can send me ## Release branches with GitLab flow -![Master and multiple release branches that vary in length with cherry-picks from master](release_branches.png) +![Master and multiple release branches that vary in length with cherry-picks from master](img/release_branches.png) You only need to work with release branches if you need to release software to the outside world. In this case, each branch contains a minor version, for example, 2-3-stable, 2-4-stable, etc. @@ -114,7 +115,7 @@ In this flow, it is not common to have a production branch (or Git flow `master` ## Merge/pull requests with GitLab flow -![Merge request with inline comments](mr_inline_comments.png) +![Merge request with inline comments](img/mr_inline_comments.png) Merge or pull requests are created in a Git management application. They ask an assigned person to merge two branches. Tools such as GitHub and Bitbucket choose the name "pull request" since the first manual action is to pull the feature branch. @@ -147,11 +148,11 @@ It also ensures that if someone reopens the issue, they can use the same branch NOTE: **Note:** When you reopen an issue you need to create a new merge request. -![Remove checkbox for branch in merge requests](remove_checkbox.png) +![Remove checkbox for branch in merge requests](img/remove_checkbox.png) ## Issue tracking with GitLab flow -![Merge request with the branch name "15-require-a-password-to-change-it" and assignee field shown](merge_request.png) +![Merge request with the branch name "15-require-a-password-to-change-it" and assignee field shown](img/merge_request.png) GitLab flow is a way to make the relation between the code and the issue tracker more transparent. @@ -192,7 +193,7 @@ It is possible that one feature branch solves more than one issue. ## Linking and closing issues from merge requests -![Merge request showing the linked issues that will be closed](close_issue_mr.png) +![Merge request showing the linked issues that will be closed](img/close_issue_mr.png) Link to issues by mentioning them in commit messages or the description of a merge request, for example, "Fixes #16" or "Duck typing is preferred. See #12." GitLab then creates links to the mentioned issues and creates comments in the issues linking back to the merge request. @@ -203,7 +204,7 @@ If you have an issue that spans across multiple repositories, create an issue fo ## Squashing commits with rebase -![Vim screen showing the rebase view](rebase.png) +![Vim screen showing the rebase view](img/rebase.png) With Git, you can use an interactive rebase (`rebase -i`) to squash multiple commits into one or reorder them. This functionality is useful if you want to replace a couple of small commits with a single commit, or if you want to make the order more logical. @@ -229,7 +230,7 @@ Git does not allow you to merge the code again otherwise. ## Reducing merge commits in feature branches -![List of sequential merge commits](merge_commits.png) +![List of sequential merge commits](img/merge_commits.png) Having lots of merge commits can make your repository history messy. Therefore, you should try to avoid merge commits in feature branches. @@ -289,7 +290,7 @@ Sharing your work before it's complete also allows for discussion and feedback a ## How to write a good commit message -![Good and bad commit message](good_commit.png) +![Good and bad commit message](img/good_commit.png) A commit message should reflect your intention, not just the contents of the commit. It is easy to see the changes in a commit, so the commit message should explain why you made those changes. @@ -300,7 +301,7 @@ For more information about formatting commit messages, please see this excellent ## Testing before merging -![Merge requests showing the test states: red, yellow, and green](ci_mr.png) +![Merge requests showing the test states: red, yellow, and green](img/ci_mr.png) In old workflows, the continuous integration (CI) server commonly ran tests on the `master` branch only. Developers had to ensure their code did not break the `master` branch. @@ -317,7 +318,7 @@ As said before, if you often have feature branches that last for more than a few ## Working with feature branches -![Shell output showing git pull output](git_pull.png) +![Shell output showing git pull output](img/git_pull.png) When creating a feature branch, always branch from an up-to-date `master`. If you know before you start that your work depends on another branch, you can also branch from there. diff --git a/doc/workflow/ci_mr.png b/doc/workflow/img/ci_mr.png Binary files differindex 85a609cb814..85a609cb814 100644 --- a/doc/workflow/ci_mr.png +++ b/doc/workflow/img/ci_mr.png diff --git a/doc/workflow/close_issue_mr.png b/doc/workflow/img/close_issue_mr.png Binary files differindex 70de2fb6cee..70de2fb6cee 100644 --- a/doc/workflow/close_issue_mr.png +++ b/doc/workflow/img/close_issue_mr.png diff --git a/doc/workflow/environment_branches.png b/doc/workflow/img/environment_branches.png Binary files differindex 0aff33c6bb8..0aff33c6bb8 100644 --- a/doc/workflow/environment_branches.png +++ b/doc/workflow/img/environment_branches.png diff --git a/doc/workflow/four_stages.png b/doc/workflow/img/four_stages.png Binary files differindex 3ef6a33d2d4..3ef6a33d2d4 100644 --- a/doc/workflow/four_stages.png +++ b/doc/workflow/img/four_stages.png diff --git a/doc/workflow/git_pull.png b/doc/workflow/img/git_pull.png Binary files differindex 0e56e59471c..0e56e59471c 100644 --- a/doc/workflow/git_pull.png +++ b/doc/workflow/img/git_pull.png diff --git a/doc/workflow/gitdashflow.png b/doc/workflow/img/gitdashflow.png Binary files differindex 65900853d84..65900853d84 100644 --- a/doc/workflow/gitdashflow.png +++ b/doc/workflow/img/gitdashflow.png diff --git a/doc/workflow/github_flow.png b/doc/workflow/img/github_flow.png Binary files differindex 21a22becdb6..21a22becdb6 100644 --- a/doc/workflow/github_flow.png +++ b/doc/workflow/img/github_flow.png diff --git a/doc/workflow/gitlab_flow.png b/doc/workflow/img/gitlab_flow.png Binary files differindex a6f3c947843..a6f3c947843 100644 --- a/doc/workflow/gitlab_flow.png +++ b/doc/workflow/img/gitlab_flow.png diff --git a/doc/workflow/good_commit.png b/doc/workflow/img/good_commit.png Binary files differindex ceb0d4b1691..ceb0d4b1691 100644 --- a/doc/workflow/good_commit.png +++ b/doc/workflow/img/good_commit.png diff --git a/doc/workflow/merge_commits.png b/doc/workflow/img/merge_commits.png Binary files differindex 4a80811c6e3..4a80811c6e3 100644 --- a/doc/workflow/merge_commits.png +++ b/doc/workflow/img/merge_commits.png diff --git a/doc/workflow/merge_request.png b/doc/workflow/img/merge_request.png Binary files differindex 010e95983fc..010e95983fc 100644 --- a/doc/workflow/merge_request.png +++ b/doc/workflow/img/merge_request.png diff --git a/doc/workflow/messy_flow.png b/doc/workflow/img/messy_flow.png Binary files differindex 4fa22d2bb5d..4fa22d2bb5d 100644 --- a/doc/workflow/messy_flow.png +++ b/doc/workflow/img/messy_flow.png diff --git a/doc/workflow/mr_inline_comments.png b/doc/workflow/img/mr_inline_comments.png Binary files differindex a18801f56e4..a18801f56e4 100644 --- a/doc/workflow/mr_inline_comments.png +++ b/doc/workflow/img/mr_inline_comments.png diff --git a/doc/workflow/production_branch.png b/doc/workflow/img/production_branch.png Binary files differindex c132d51bfb6..c132d51bfb6 100644 --- a/doc/workflow/production_branch.png +++ b/doc/workflow/img/production_branch.png diff --git a/doc/workflow/rebase.png b/doc/workflow/img/rebase.png Binary files differindex fe865177ba8..fe865177ba8 100644 --- a/doc/workflow/rebase.png +++ b/doc/workflow/img/rebase.png diff --git a/doc/workflow/release_branches.png b/doc/workflow/img/release_branches.png Binary files differindex 0a7f61d0248..0a7f61d0248 100644 --- a/doc/workflow/release_branches.png +++ b/doc/workflow/img/release_branches.png diff --git a/doc/workflow/remove_checkbox.png b/doc/workflow/img/remove_checkbox.png Binary files differindex fb0e792b37b..fb0e792b37b 100644 --- a/doc/workflow/remove_checkbox.png +++ b/doc/workflow/img/remove_checkbox.png |