docs: Simplified Component Overview should be updated at GitLab Architecture Overview
History of the target diagram
2014
We (community, @samrocketman) started to 3671984b (gitlabhq/gitlabhq#6185 on GitHub (before gitlab.com)). This is what I used when I understood GitLab architecture in 2014-2015
| Image | ![]() |
|---|
2016
After 2 years, in gitlab-foss!3694 (merged) @axil replaced the colorful original with the black-white simplified one. It looks that another colorful one was suggested but not approved in that MR: gitlab-foss!3694 (fd9eb403)
| Image | ![]() |
|---|
And then, at the end of year, gitlab-foss!8264 (merged) added Gitaly to the diagram.
| Image | ![]() |
|---|
gitlab-foss!28397 (merged) found that that diagram has become unused and orphan between 2016 and 2019. (in 2017 in gitlab-foss!11617 (merged) @ernstvn-gitlab removed it.)
2019
After 3 years, in gitlab-foss!28729 (merged), @rnienaber re-introduced this kind of schematic diagram.
2022
After other 3 years, in !82573 (merged), @tnir updated the diagram to follow the latest architecture.
Problem to solve
Simplified Component Overview does not look up to date at https://docs.gitlab.com/ee/development/architecture.html
Definition of done
-
Architecture diagram shows new developers enough components and relationship between them as of %14.9.



