[{"data":1,"prerenderedAt":1118},["ShallowReactive",2],{"/blog/tips-for-better-code-review":3,"navigation-en-us":364,"banner-en-us":802,"footer-en-us":810,"blog-post-authors-en-us-David O'Regan":1057,"blog-related-posts-en-us-tips-for-better-code-review":1073,"blog-share-wrapper-en-us":1098,"next-steps-en-us":1108},{"id":4,"title":5,"authors":6,"body":8,"category":344,"date":345,"description":346,"extension":347,"externalUrl":348,"faq":348,"featured":349,"heroImage":350,"hidePromo":349,"meta":351,"navigation":352,"path":353,"seo":354,"slug":358,"stem":359,"tags":360,"template":362,"updatedDate":348,"__hash__":363},"blogPosts/en-us/blog/tips-for-better-code-review.md","How to write a more thoughtful code review",[7],"David O'Regan",{"type":9,"value":10,"toc":331},"minimark",[11,21,24,29,38,41,95,99,107,112,121,124,127,130,138,141,147,155,158,161,164,167,175,178,187,191,194,203,211,215,218,223,243,248,259,262,266,269,272,275,289,292,295,298,306,309,312,317],[12,13,14,15,20],"p",{},"This post is adapted from a ",[16,17,19],"a",{"href":18},"/blog/better-code-reviews/","GitLab Unfiltered blog post"," written by David O'Regan.",[12,22,23],{},"Feedback matters to our personal and professional lives and software is no different. We deliver most if not all of our feedback to one another at GitLab using code reviews. We’re sharing some of our tools for you to add to your toolbelt when it comes to code reviews. In this post (the first of a three-part series) we share communication strategies for authors and reviewers.",[25,26,28],"h2",{"id":27},"remember-details-matter-for-self-reviews","Remember: Details matter for self-reviews",[12,30,31,32,37],{},"At GitLab, the ",[16,33,36],{"href":34,"rel":35},"https://docs.gitlab.com/development/code_review/#the-responsibility-of-the-merge-request-author",[],"responsibility for the code lies with the merge request author",". We suggest code authors create a checklist to ensure that your i’s are dotted and your t’s are crossed before requesting a review. Here is an example MR checklist:",[12,39,40],{},"Before every feedback cycle:",[42,43,44,48,51,54,57,60,69,84,87],"ul",{},[45,46,47],"li",{},"Re-read every line.",[45,49,50],{},"Test your code locally.",[45,52,53],{},"Write a test for every change (or as many as you can).",[45,55,56],{},"Write a clear description and update it after each feedback cycle.",[45,58,59],{},"Include at least one screenshot per change. More is better.",[45,61,62,63,68],{},"Check and re-check your ",[16,64,67],{"href":65,"rel":66},"https://docs.gitlab.com/user/project/labels/",[],"labels",". Then check them again.",[45,70,71,72,77,78,83],{},"Consider using a ~\"workflow::refinement\" label for issues ahead of time as we do in the ",[16,73,76],{"href":74,"rel":75},"https://handbook.gitlab.com/handbook/engineering/monitoring/",[],"Monitor:Health team",". Read the documentation to ",[16,79,82],{"href":80,"rel":81},"https://docs.gitlab.com/user/project/labels/#scoped-labels",[],"learn more about scoped labels",".",[45,85,86],{},"Review the code as if you were the reviewer. Be proactive, answer the likely questions, and open follow-up issues ahead of time.",[45,88,89,90,83],{},"If you want to see the last and most important part in the action, see how one of our frontend maintainers Natalia Tepluhina ",[16,91,94],{"href":92,"rel":93},"https://gitlab.com/gitlab-org/gitlab/-/merge_requests/33587#note_353564612",[],"pre-answered a question she knew would be asked in one of her merge requests",[25,96,98],{"id":97},"communicate-with-good-intentions","Communicate with good intentions",[12,100,101,102,83],{},"One of the hardest parts of getting a code review right is communicating the human touch. When we give and receive feedback, human habit can create cognitive distortion by defaulting to the most negative aspects of that feedback. At GitLab, we try to highlight the importance of assuming positive intent by incorporating it in our ",[16,103,106],{"href":104,"rel":105},"https://handbook.gitlab.com/handbook/values/#assume-positive-intent",[],"value system",[108,109,111],"h3",{"id":110},"how-the-conventional-comments-system-can-help-in-code-review","How the conventional comments system can help in code review",[12,113,114,115,120],{},"To give feedback more effectively, try the ",[16,116,119],{"href":117,"rel":118},"https://conventionalcomments.org/",[],"conventional comments system",", which was developed by senior frontend engineer, Paul Slaughter. The conventional comments system calls for writing comments in a way that is useful for the reviewer and author of the merge request. It's so popular that one person made a browser extension (Chrome, Firefox) for it.",[12,122,123],{},"The convention comment system calls for starting a comment with a single, eye-catching word that defines the intent and tone for the comment. This method gives the reader a chance to understand where your comment is coming from.",[12,125,126],{},"Let's try an experiment. If you submitted code for review, which comment would you prefer to read?",[12,128,129],{},"Option one: What do you think about X instead?",[12,131,132,133,137],{},"Option two: ",[134,135,136],"strong",{},"suggestion (non-blocking)","\nWhat do you think about X instead?",[12,139,140],{},"You likely chose option two because it provided context for the comment, communicated empathy, and was framed as an invitation to try a different approach, instead of being written as a command or mandatory change.",[12,142,143,144,146],{},"The magic part of this comment is the first line ",[134,145,136],{},". Straight away, before you even read the comment, you know the two most important things about it:",[42,148,149,152],{},[45,150,151],{},"It's a suggestion from the reviewer",[45,153,154],{},"It's non-blocking. Which means it's more of a friendly suggestion than a hard change that's necessary for the stability of the code.",[12,156,157],{},"Another advantage to this style of commenting is it allows merge request authors to understand the reviewer is not blocking their work. By highlighting what counts as a blocking and non-blocking comment, merge authors get the full context of what the reviewer is trying to communicate.",[12,159,160],{},"For example, you have submitted a merge request for review and your review comes back with eight comments.",[12,162,163],{},"The first option has no context in the comments. All comments are treated equally because they lack context for what counts as a blocker and what doesn't.",[12,165,166],{},"Option two contextualizes comments using the conventional comments system. The comments can be treated by priority:",[42,168,169,172],{},[45,170,171],{},"Blockers: What needs to get the merge over the line.",[45,173,174],{},"Non-blockers: What can be a separate merge or perhaps will spark a discussion.",[12,176,177],{},"Next time you're reviewing code, try using the conventional comments approach. Pay attention to how it affects the way the merge request author responds to the review but also how you, the reviewer, feel leaving the review. We are considering integrating this feature directly into GitLab because we believe in making GitLab the best possible place for code reviews.",[12,179,180,181,186],{},"If you want to see a real-life example of some of Paul's work using conventional comments, check out ",[16,182,185],{"href":183,"rel":184},"https://gitlab.com/gitlab-org/gitlab/-/merge_requests/24897",[],"his reviews of my community contributions"," here at GitLab – you’ll see his empathy really shines through.",[25,188,190],{"id":189},"the-role-of-fairness-in-code-review","The role of \"fairness\" in code review",[12,192,193],{},"In many ways, code review is a form of negotiation, where the result of the negotiation is a selection of code that's valuable and held to a high standard. Central to being a good code reviewer (and good negotiator) is fairness. In fact, being a fair negotiator is often the most useful tool for code authors and code reviewers.",[12,195,196,197,202],{},"Fairness is actually mentioned twice in the ",[16,198,201],{"href":199,"rel":200},"https://handbook.gitlab.com/handbook/values/#permission-to-play",[],"permissions to play guidelines"," at GitLab:",[42,204,205,208],{},[45,206,207],{},"\"Be dependable, reliable, fair, and respectful.\"",[45,209,210],{},"\"Seek out ways to be fair to everyone.\"",[108,212,214],{"id":213},"how-to-be-a-fair-author","How to be a fair author",[12,216,217],{},"In many ways, being a fair author is the easiest. Here are a few simple Dos and Don'ts to remember:",[12,219,220],{},[134,221,222],{},"Do:",[42,224,225,228,231,234],{},[45,226,227],{},"Write a proper description with screenshots (can't stress this one enough!)",[45,229,230],{},"Understand a reviewer’s point of view when they make suggestions",[45,232,233],{},"Address any strange parts of your merge upfront (we all have them)",[45,235,236,237,242],{},"Be ",[16,238,241],{"href":239,"rel":240},"https://handbook.gitlab.com/handbook/values/#collaboration",[],"open to collaboration"," on your work",[12,244,245],{},[134,246,247],{},"Don't:",[42,249,250,253,256],{},[45,251,252],{},"\"plz merge\"",[45,254,255],{},"Be closed off or take offense to suggestions",[45,257,258],{},"Forget to include any steps necessary for the build to run (or in other words, reduce the burden where possible)",[12,260,261],{},"Honestly, it's pretty simple to be a fair author of a merge request. Even the smallest amount of empathy goes a long way, particularly when you remember that the person reviewing your code gets nothing extra for their efforts. They just want to help take your merge to the next level.",[108,263,265],{"id":264},"how-to-be-a-fair-reviewer","How to be a fair reviewer",[12,267,268],{},"Being fair as a reviewer is a bit more challenging because every individual has opinions or biases about how a piece of code should be written. Bias is something we all deal with when it comes to how we want things to be because we all have our own styles, preferences, and ideas about how software should be written.",[12,270,271],{},"Bias can create problems when it comes to code reviews because it's common for personal preferences to emerge when reviewing someone else's code. The typical reviewer might catch themselves thinking in absolutes, and the number of unresolved comments grows.",[12,273,274],{},"If you have ever reviewed a merge request and found yourself thinking things like:",[42,276,277,280,283,286],{},[45,278,279],{},"\"It should be written like this\"",[45,281,282],{},"\"Why would they do it like that?\"",[45,284,285],{},"\"I would have done it this way\"",[45,287,288],{},"\"That's not how that should be done!\"",[12,290,291],{},"If this sounds familiar, then you may have fallen victim to a common cognitive distortion: Should/must statements.",[12,293,294],{},"It is important for any reviewer to remember that just because a code author wrote code in a different style or manner from you, doesn't mean that the code is written incorrectly. If you catch yourself writing a review comment that includes the words \"should\" or \"must\" then you ought to take a step back and think about whether your suggestions are coming from a place of fairness or a place of bias. Ask yourself: Is the use of absolutes warranted here? Sometimes it will be both fair and warranted. One example is if your company follows a set of coding conventions like we do at GitLab. Stay vigilant for times when those statements are a thin veil for a personal preference.",[12,296,297],{},"If you do need to use a should/must statement, be sure to back up your assertions with documentation to help the code author understand why a change must be made.",[12,299,300,301,305],{},"Typically, the fair response to something you don't agree with is to ask ",[302,303,304],"em",{},"why"," an author wrote code this way, instead of saying it must be another way.",[12,307,308],{},"This is part one of a three-part series on code review. Up next we will be explaining why patch files are a useful tool for reviewers.",[12,310,311],{},"If you have questions or comments about code reviews, creating smaller MRs, or iteration, leave us a comment on this blog post!",[12,313,314],{},[302,315,316],{},"Sara Kassabian contributed to this blog post.",[12,318,319,320,325,326,83],{},"Cover image by ",[16,321,324],{"href":322,"rel":323},"https://unsplash.com/@simmerdownjpg",[],"Jackson Simmer"," on ",[16,327,330],{"href":328,"rel":329},"https://unsplash.com/photos/Vqg809B-SrE",[],"Unsplash",{"title":332,"searchDepth":333,"depth":333,"links":334},"",2,[335,336,340],{"id":27,"depth":333,"text":28},{"id":97,"depth":333,"text":98,"children":337},[338],{"id":110,"depth":339,"text":111},3,{"id":189,"depth":333,"text":190,"children":341},[342,343],{"id":213,"depth":339,"text":214},{"id":264,"depth":339,"text":265},"engineering","2021-03-09","The best code reviews are empathetic and fair. We explain best practices for providing feedback.","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749663502/Blog/Hero%20Images/paperclips.jpg",{},true,"/en-us/blog/tips-for-better-code-review",{"title":5,"description":346,"ogTitle":5,"ogDescription":346,"noIndex":349,"ogImage":350,"ogUrl":355,"ogSiteName":356,"ogType":357,"canonicalUrls":355},"https://about.gitlab.com/blog/tips-for-better-code-review","https://about.gitlab.com","article","tips-for-better-code-review","en-us/blog/tips-for-better-code-review",[361],"code review","BlogPost","UWnSzhGVBYmSAzaSISrPe0JTTmC0ca7Gg8WF0_dOHYM",{"logo":365,"freeTrial":370,"sales":375,"login":380,"items":385,"search":721,"minimal":753,"duo":772,"switchNav":781,"pricingDeployment":792},{"config":366},{"href":367,"dataGaName":368,"dataGaLocation":369},"/","gitlab logo","header",{"text":371,"config":372},"Get free trial",{"href":373,"dataGaName":374,"dataGaLocation":369},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":376,"config":377},"Request a demo",{"href":378,"dataGaName":379,"dataGaLocation":369},"/request-a-demo/","sales",{"text":381,"config":382},"Sign in",{"href":383,"dataGaName":384,"dataGaLocation":369},"https://gitlab.com/users/sign_in/","sign in",[386,472,560,565,645,699],{"text":387,"left":352,"config":388,"menu":390},"Platform",{"dataNavLevelOne":389},"platform",{"type":391,"link":392,"columns":396,"feature":461},"lists",{"text":393,"config":394},"Explore the Platform",{"href":395,"dataGaName":389,"dataGaLocation":369},"/platform/",[397,420,443],{"title":398,"items":399},"DevOps",[400,405,410,415],{"text":401,"config":402},"CI/CD",{"href":403,"dataGaLocation":369,"dataGaName":404},"/solutions/continuous-integration/","ci/cd",{"text":406,"config":407},"Source Code Management",{"href":408,"dataGaLocation":369,"dataGaName":409},"/solutions/source-code-management/","source code management",{"text":411,"config":412},"Agile Delivery",{"href":413,"dataGaLocation":369,"dataGaName":414},"/solutions/agile-delivery/","agile delivery",{"text":416,"config":417},"Artifact Management",{"href":418,"dataGaLocation":369,"dataGaName":419},"/artifact-central/","artifact management",{"title":421,"items":422},"Security & Governance",[423,428,433,438],{"text":424,"config":425},"Application Security Testing",{"href":426,"dataGaLocation":369,"dataGaName":427},"/solutions/application-security-testing/","application security testing",{"text":429,"config":430},"Governance & Compliance",{"href":431,"dataGaLocation":369,"dataGaName":432},"/solutions/software-compliance/","governance and compliance",{"text":434,"config":435},"Secrets Management",{"href":436,"dataGaLocation":369,"dataGaName":437},"/gitlab-secrets-manager/","secrets management",{"text":439,"config":440},"Supply Chain Security",{"href":441,"dataGaLocation":369,"dataGaName":442},"/solutions/supply-chain/","supply chain security",{"title":444,"items":445},"Agentic AI & Context",[446,451,456],{"text":447,"config":448},"Duo Agent Platform",{"href":449,"dataGaLocation":369,"dataGaName":450},"/gitlab-duo-agent-platform/","duo agent platform",{"text":452,"config":453},"Orbit Context Graph",{"href":454,"dataGaLocation":369,"dataGaName":455},"/gitlab-orbit/","orbit",{"text":457,"config":458},"Visibility & Measurement",{"href":459,"dataGaLocation":369,"dataGaName":460},"/solutions/visibility-measurement/","visibility and measurement",{"config":462,"title":465,"text":466,"link":467},{"background":463,"textColor":464},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1790185102/o7dn32anqcb6z8dgd3as.jpg')","#000","GitLab Orbit is generally available","Higher agent accuracy, lower token cost",{"text":468,"config":469},"Read the announcement",{"href":470,"dataGaName":471,"dataGaLocation":369},"/blog/gitlab-orbit-ga/","orbit ga announcement",{"text":473,"left":352,"config":474,"menu":476},"Solutions",{"dataNavLevelOne":475},"solutions",{"type":391,"link":477,"columns":481,"feature":551},{"text":478,"config":479},"View all Solutions",{"href":480,"dataGaName":475,"dataGaLocation":369},"/solutions/",[482,500,518],{"title":483,"items":484},"Outcomes",[485,490,495],{"text":486,"config":487},"DevOps Modernization",{"href":488,"dataGaLocation":369,"dataGaName":489},"/assessments/devops-modernization-assessment/","devops modernization",{"text":491,"config":492},"Security Modernization",{"href":493,"dataGaLocation":369,"dataGaName":494},"/assessments/security-modernization-assessment/","security modernization",{"text":496,"config":497},"AI Modernization",{"href":498,"dataGaLocation":369,"dataGaName":499},"/assessments/ai-modernization-assessment/","ai modernization",{"title":501,"items":502},"By size",[503,508,513],{"text":504,"config":505},"Enterprise",{"href":506,"dataGaLocation":369,"dataGaName":507},"/enterprise/","enterprise",{"text":509,"config":510},"Small Business",{"href":511,"dataGaLocation":369,"dataGaName":512},"/small-business/","small business",{"text":514,"config":515},"Startups",{"href":516,"dataGaLocation":369,"dataGaName":517},"/solutions/startups/","startups",{"title":519,"items":520},"Industries",[521,526,531,536,541,546],{"text":522,"config":523},"Financial Services",{"href":524,"dataGaLocation":369,"dataGaName":525},"/solutions/finance/","financial services",{"text":527,"config":528},"Public Sector",{"href":529,"dataGaLocation":369,"dataGaName":530},"/solutions/public-sector/","public sector",{"text":532,"config":533},"Telecommunications",{"href":534,"dataGaLocation":369,"dataGaName":535},"/solutions/telecommunications/","telecommunications",{"text":537,"config":538},"Automotive",{"href":539,"dataGaLocation":369,"dataGaName":540},"/solutions/automotive/","automotive",{"text":542,"config":543},"Education",{"href":544,"dataGaLocation":369,"dataGaName":545},"/solutions/education/","education",{"text":547,"config":548},"Aerospace",{"href":549,"dataGaLocation":369,"dataGaName":550},"/solutions/aerospace/","aerospace",{"config":552,"title":553,"text":554,"link":555},{"background":463,"textColor":464},"GitLab Security Standard","Learn how to harden your software factory and let AI agents earn autonomy, without trading away security.",{"text":556,"config":557},"Explore the standard",{"href":558,"dataGaName":559,"dataGaLocation":369},"/gitlab-security-standard/","gitlab security standard",{"text":561,"config":562},"Pricing",{"href":563,"dataGaName":564,"dataGaLocation":369,"dataNavLevelOne":564},"/pricing/","pricing",{"text":566,"config":567,"menu":569},"Resources",{"dataNavLevelOne":568},"resources",{"type":391,"link":570,"columns":574,"feature":636},{"text":571,"config":572},"View all resources",{"href":573,"dataGaName":568,"dataGaLocation":369},"/resources/",[575,608],{"title":576,"items":577},"Discover",[578,583,588,593,598,603],{"text":579,"config":580},"Docs",{"href":581,"dataGaName":582,"dataGaLocation":369},"https://docs.gitlab.com/","docs",{"text":584,"config":585},"University",{"href":586,"dataGaName":587,"dataGaLocation":369},"https://university.gitlab.com/","university",{"text":589,"config":590},"Demo Series",{"href":591,"dataGaName":592,"dataGaLocation":369},"/gitlab-technical-demo-series/","demo series",{"text":594,"config":595},"Demo Hub",{"href":596,"dataGaName":597,"dataGaLocation":369},"/demo-hub/","demo hub",{"text":599,"config":600},"Services",{"href":601,"dataGaName":602,"dataGaLocation":369},"/services/","services",{"text":604,"config":605},"Well Architected",{"href":606,"dataGaName":607,"dataGaLocation":369},"/resources/well-architected/","well architected",{"title":609,"items":610},"Connect",[611,616,621,626,631],{"text":612,"config":613},"Blog",{"href":614,"dataGaName":615,"dataGaLocation":369},"/blog/","blog",{"text":617,"config":618},"Community",{"href":619,"dataGaName":620,"dataGaLocation":369},"/community/","community",{"text":622,"config":623},"Customers",{"href":624,"dataGaName":625,"dataGaLocation":369},"/customers/","customers",{"text":627,"config":628},"Partners",{"href":629,"dataGaName":630,"dataGaLocation":369},"/partners/","partners",{"text":632,"config":633},"Events",{"href":634,"dataGaName":635,"dataGaLocation":369},"/events/","events",{"config":637,"title":638,"text":639,"link":640},{"background":463,"textColor":464},"What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":641,"config":642},"Read the latest",{"href":643,"dataGaName":644,"dataGaLocation":369},"/whats-new/","whats new",{"text":646,"config":647,"menu":649},"Company",{"dataNavLevelOne":648},"company",{"type":391,"columns":650},[651],{"items":652},[653,658,664,669,674,679,684,689,694],{"text":654,"config":655},"About",{"href":656,"dataGaName":657,"dataGaLocation":369},"/company/","about",{"text":659,"config":660,"footerGa":663},"Jobs",{"href":661,"dataGaName":662,"dataGaLocation":369},"/jobs/","jobs",{"dataGaName":662},{"text":665,"config":666},"Press",{"href":667,"dataGaName":668,"dataGaLocation":369},"/press/","press",{"text":670,"config":671},"Handbook",{"href":672,"dataGaName":673,"dataGaLocation":369},"https://handbook.gitlab.com/","handbook",{"text":675,"config":676},"Leadership",{"href":677,"dataGaName":678,"dataGaLocation":369},"/company/team/e-group/","leadership",{"text":680,"config":681},"Investor relations",{"href":682,"dataGaName":683,"dataGaLocation":369},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":685,"config":686},"Trust Center",{"href":687,"dataGaName":688,"dataGaLocation":369},"/security/","trust center",{"text":690,"config":691},"AI Transparency Center",{"href":692,"dataGaName":693,"dataGaLocation":369},"/ai-transparency-center/","ai transparency center",{"text":695,"config":696},"Newsletter",{"href":697,"dataGaName":698,"dataGaLocation":369},"/company/contact/#contact-forms","newsletter",{"text":700,"config":701,"menu":702},"Contact us",{"dataNavLevelOne":648},{"type":391,"columns":703},[704],{"items":705},[706,711,716],{"text":707,"config":708},"Talk to sales",{"href":709,"dataGaName":710,"dataGaLocation":369},"/sales/","talk to sales",{"text":712,"config":713},"Support portal",{"href":714,"dataGaName":715,"dataGaLocation":369},"https://support.gitlab.com/hc/en-us","support portal",{"text":717,"config":718},"Customer portal",{"href":719,"dataGaName":720,"dataGaLocation":369},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":722,"login":723,"suggestions":730},"Close",{"text":724,"link":725},"To search repositories and projects, login to",{"text":726,"config":727},"gitlab.com",{"href":383,"dataGaName":728,"dataGaLocation":729},"search login","search",{"text":731,"default":732},"Suggestions",[733,736,739,741,745,749],{"text":734,"config":735},"GitLab Duo Agent Platform",{"href":449,"dataGaName":734,"dataGaLocation":729},{"text":737,"config":738},"Code Suggestions (AI)",{"href":449,"dataGaName":737,"dataGaLocation":729},{"text":401,"config":740},{"href":403,"dataGaName":401,"dataGaLocation":729},{"text":742,"config":743},"GitLab on AWS",{"href":744,"dataGaName":742,"dataGaLocation":729},"/partners/technology-partners/aws/",{"text":746,"config":747},"GitLab on Google Cloud",{"href":748,"dataGaName":746,"dataGaLocation":729},"/partners/technology-partners/google-cloud-platform/",{"text":750,"config":751},"Why GitLab?",{"href":752,"dataGaName":750,"dataGaLocation":729},"/why-gitlab/",{"freeTrial":754,"mobileIcon":759,"desktopIcon":764,"secondaryButton":767},{"text":755,"config":756},"Start free trial",{"href":757,"dataGaName":374,"dataGaLocation":758},"https://gitlab.com/-/trials/new/","nav",{"altText":760,"config":761},"Gitlab Icon",{"src":762,"dataGaName":763,"dataGaLocation":758},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":760,"config":765},{"src":766,"dataGaName":763,"dataGaLocation":758},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":768,"config":769},"Get Started",{"href":770,"dataGaName":771,"dataGaLocation":758},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":773,"mobileIcon":777,"desktopIcon":779},{"text":774,"config":775},"Learn more about GitLab Duo",{"href":449,"dataGaName":776,"dataGaLocation":758},"gitlab duo",{"altText":760,"config":778},{"src":762,"dataGaName":763,"dataGaLocation":758},{"altText":760,"config":780},{"src":766,"dataGaName":763,"dataGaLocation":758},{"button":782,"mobileIcon":787,"desktopIcon":789},{"text":783,"config":784},"/switch",{"href":785,"dataGaName":786,"dataGaLocation":758},"#contact","switch",{"altText":760,"config":788},{"src":762,"dataGaName":763,"dataGaLocation":758},{"altText":760,"config":790},{"src":791,"dataGaName":763,"dataGaLocation":758},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":793,"mobileIcon":798,"desktopIcon":800},{"text":794,"config":795},"Back to pricing",{"href":563,"dataGaName":796,"dataGaLocation":758,"icon":797},"back to pricing","GoBack",{"altText":760,"config":799},{"src":762,"dataGaName":763,"dataGaLocation":758},{"altText":760,"config":801},{"src":766,"dataGaName":763,"dataGaLocation":758},{"title":803,"button":804,"config":808},"GitLab Orbit is generally available. Increase agent accuracy and lower token cost",{"text":468,"config":805},{"href":470,"dataGaName":806,"dataGaLocation":807},"orbit-ga-banner","global-banner",{"layout":809,"disabled":349},"release",{"data":811},{"text":812,"config":813,"items":818,"minimal":1046},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"twitter":814,"facebook":815,"youtube":816,"linkedin":817},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[819,867,926,973,1014],{"title":561,"links":820,"subMenu":836},[821,826,831],{"text":822,"config":823},"View plans",{"href":563,"dataGaName":824,"dataGaLocation":825},"view plans","footer",{"text":827,"config":828},"Why Premium?",{"href":829,"dataGaName":830,"dataGaLocation":825},"/pricing/premium/","why premium",{"text":832,"config":833},"Why Ultimate?",{"href":834,"dataGaName":835,"dataGaLocation":825},"/pricing/ultimate/","why ultimate",[837],{"title":838,"links":839},"Contact Us",[840,843,845,847,852,857,862],{"text":841,"config":842},"Contact sales",{"href":709,"dataGaName":379,"dataGaLocation":825},{"text":712,"config":844},{"href":714,"dataGaName":715,"dataGaLocation":825},{"text":717,"config":846},{"href":719,"dataGaName":720,"dataGaLocation":825},{"text":848,"config":849},"Status",{"href":850,"dataGaName":851,"dataGaLocation":825},"https://status.gitlab.com/","status",{"text":853,"config":854},"Terms of use",{"href":855,"dataGaName":856,"dataGaLocation":825},"/terms/","terms of use",{"text":858,"config":859},"Privacy statement",{"href":860,"dataGaName":861,"dataGaLocation":825},"/privacy/","privacy statement",{"text":863,"config":864},"Cookie preferences",{"dataGaName":865,"dataGaLocation":825,"id":866,"isOneTrustButton":352},"cookie preferences","ot-sdk-btn",{"title":387,"links":868,"subMenu":884},[869,872,874,876,878,880],{"text":870,"config":871},"Explore the platform",{"href":395,"dataGaName":389,"dataGaLocation":825},{"text":447,"config":873},{"href":449,"dataGaName":450,"dataGaLocation":825},{"text":401,"config":875},{"href":403,"dataGaName":404,"dataGaLocation":825},{"text":452,"config":877},{"href":454,"dataGaName":455,"dataGaLocation":825},{"text":434,"config":879},{"href":436,"dataGaName":437,"dataGaLocation":825},{"text":881,"config":882},"Why GitLab",{"href":752,"dataGaName":883,"dataGaLocation":825},"why gitlab",[885],{"title":886,"links":887},"Topics",[888,892,897,901,906,911,916,921],{"text":401,"config":889},{"href":890,"dataGaName":891,"dataGaLocation":825},"/topics/ci-cd/","cicd",{"text":893,"config":894},"GitOps",{"href":895,"dataGaName":896,"dataGaLocation":825},"/topics/gitops/","gitops",{"text":398,"config":898},{"href":899,"dataGaName":900,"dataGaLocation":825},"/topics/devops/","devops",{"text":902,"config":903},"Version Control",{"href":904,"dataGaName":905,"dataGaLocation":825},"/topics/version-control/","version control",{"text":907,"config":908},"DevSecOps",{"href":909,"dataGaName":910,"dataGaLocation":825},"/topics/devsecops/","devsecops",{"text":912,"config":913},"Cloud Native",{"href":914,"dataGaName":915,"dataGaLocation":825},"/topics/cloud-native/","cloud native",{"text":917,"config":918},"AI for Coding",{"href":919,"dataGaName":920,"dataGaLocation":825},"/topics/devops/ai-for-coding/","ai for coding",{"text":922,"config":923},"Agentic AI",{"href":924,"dataGaName":925,"dataGaLocation":825},"/topics/agentic-ai/","agentic ai",{"title":473,"links":927},[928,931,934,937,940,943,945,947,949,951,953,956,958,961,965,969],{"text":929,"config":930},"DevOps modernization",{"href":488,"dataGaName":489,"dataGaLocation":825},{"text":932,"config":933},"Security modernization",{"href":493,"dataGaName":494,"dataGaLocation":825},{"text":935,"config":936},"AI modernization",{"href":498,"dataGaName":499,"dataGaLocation":825},{"text":938,"config":939},"Financial services",{"href":524,"dataGaName":525,"dataGaLocation":825},{"text":941,"config":942},"Public sector",{"href":529,"dataGaName":530,"dataGaLocation":825},{"text":532,"config":944},{"href":534,"dataGaName":535,"dataGaLocation":825},{"text":537,"config":946},{"href":539,"dataGaName":540,"dataGaLocation":825},{"text":542,"config":948},{"href":544,"dataGaName":545,"dataGaLocation":825},{"text":547,"config":950},{"href":549,"dataGaName":550,"dataGaLocation":825},{"text":504,"config":952},{"href":506,"dataGaName":507,"dataGaLocation":825},{"text":954,"config":955},"Small business",{"href":511,"dataGaName":512,"dataGaLocation":825},{"text":514,"config":957},{"href":516,"dataGaName":517,"dataGaLocation":825},{"text":893,"config":959},{"href":960,"dataGaName":896,"dataGaLocation":825},"/solutions/gitops/",{"text":962,"config":963},"Software composition analysis",{"href":441,"dataGaName":964,"dataGaLocation":825},"software composition analysis",{"text":966,"config":967},"Value stream management",{"href":459,"dataGaName":968,"dataGaLocation":825},"value stream management",{"text":970,"config":971},"All solutions",{"href":480,"dataGaName":972,"dataGaLocation":825},"all solutions",{"title":566,"links":974},[975,980,985,987,989,991,993,995,997,999,1001,1003,1005,1007,1010],{"text":976,"config":977},"Install",{"href":978,"dataGaName":979,"dataGaLocation":825},"/install/","install",{"text":981,"config":982},"Quick start guides",{"href":983,"dataGaName":984,"dataGaLocation":825},"/get-started/","quick setup checklists",{"text":579,"config":986},{"href":581,"dataGaName":582,"dataGaLocation":825},{"text":584,"config":988},{"href":586,"dataGaName":587,"dataGaLocation":825},{"text":589,"config":990},{"href":591,"dataGaName":592,"dataGaLocation":825},{"text":594,"config":992},{"href":596,"dataGaName":597,"dataGaLocation":825},{"text":599,"config":994},{"href":601,"dataGaName":602,"dataGaLocation":825},{"text":612,"config":996},{"href":614,"dataGaName":615,"dataGaLocation":825},{"text":617,"config":998},{"href":619,"dataGaName":620,"dataGaLocation":825},{"text":622,"config":1000},{"href":624,"dataGaName":625,"dataGaLocation":825},{"text":627,"config":1002},{"href":629,"dataGaName":630,"dataGaLocation":825},{"text":632,"config":1004},{"href":634,"dataGaName":635,"dataGaLocation":825},{"text":695,"config":1006},{"href":697,"dataGaName":698,"dataGaLocation":825},{"text":1008,"config":1009},"What's new",{"href":643,"dataGaName":644,"dataGaLocation":825},{"text":1011,"config":1012},"All resources",{"href":573,"dataGaName":1013,"dataGaLocation":825},"all resources",{"title":646,"links":1015},[1016,1018,1020,1022,1024,1026,1028,1030,1032,1036,1041],{"text":654,"config":1017},{"href":656,"dataGaName":648,"dataGaLocation":825},{"text":659,"config":1019},{"href":661,"dataGaName":662,"dataGaLocation":825},{"text":665,"config":1021},{"href":667,"dataGaName":668,"dataGaLocation":825},{"text":670,"config":1023},{"href":672,"dataGaName":673,"dataGaLocation":825},{"text":675,"config":1025},{"href":677,"dataGaName":678,"dataGaLocation":825},{"text":680,"config":1027},{"href":682,"dataGaName":683,"dataGaLocation":825},{"text":685,"config":1029},{"href":687,"dataGaName":688,"dataGaLocation":825},{"text":690,"config":1031},{"href":692,"dataGaName":693,"dataGaLocation":825},{"text":1033,"config":1034},"Sustainability",{"href":1035,"dataGaName":1033,"dataGaLocation":825},"/sustainability/",{"text":1037,"config":1038},"Diversity, inclusion and belonging (DIB)",{"href":1039,"dataGaName":1040,"dataGaLocation":825},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":1042,"config":1043},"Modern Slavery Transparency Statement",{"href":1044,"dataGaName":1045,"dataGaLocation":825},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":1047},[1048,1051,1054],{"text":1049,"config":1050},"Terms",{"href":855,"dataGaName":856,"dataGaLocation":825},{"text":1052,"config":1053},"Cookies",{"dataGaName":865,"dataGaLocation":825,"id":866,"isOneTrustButton":352},{"text":1055,"config":1056},"Privacy",{"href":860,"dataGaName":861,"dataGaLocation":825},[1058],{"id":1059,"title":1060,"body":348,"config":1061,"content":1063,"description":348,"extension":1067,"meta":1068,"navigation":352,"path":1069,"seo":1070,"stem":1071,"__hash__":1072},"blogAuthors/en-us/blog/authors/david-oregan.yml","David Oregan",{"template":1062},"BlogAuthor",{"name":7,"config":1064},{"headshot":1065,"ctfId":1066},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749659853/Blog/Author%20Headshots/oregand-headshot.png","oregand","yml",{},"/en-us/blog/authors/david-oregan",{},"en-us/blog/authors/david-oregan","CX5gLc3Gs5FrmvpMNVkBtC5zRi3vj8l3wJGnW0iSa6Y",[1074,1082,1090],{"title":1075,"description":1076,"heroImage":1077,"category":344,"date":1078,"authors":1079,"slug":1081,"externalUrl":348},"Two front doors: Module-level access in a Django GRC app","A technical deep-dive on restructuring a Django internal tool to support two distinct GitLab teams: Security Compliance and Internal Audit.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750097663/Blog/Hero%20Images/Blog/Hero%20Images/Workflow%201800x945_2gQoQIbY9NvjLFpXtsxtXy_1750097663612.png","2026-10-05",[1080],"Donovan Felton","module-level-access-in-a-django-grc-app",{"title":1083,"description":1084,"heroImage":1085,"category":344,"date":1086,"authors":1087,"slug":1089,"externalUrl":348},"How GitLab reduced code-per-agentic-flow ratio by 45%","Learn how Flow Registry, a component-based framework that compiles YAML configurations into fully functional LangGraph flows, helped improve scalability and more.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-09-22",[1088],"Mikolaj Wawrzyniak","how-gitlab-reduced-code-per-agentic-flow-ratio",{"title":1091,"description":1092,"heroImage":1093,"category":344,"date":1094,"authors":1095,"slug":1097,"externalUrl":348},"Co-Create: Building GitLab with our users","How GitLab users collaborated with us to build practical product improvements in the first half of 2026.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750099203/Blog/Hero%20Images/Blog/Hero%20Images/blog-image-template-1800x945%20%2820%29_2bJGC5ZP3WheoqzlLT05C5_1750099203484.png","2026-09-10",[1096],"Isa Huerga","co-create-h1-2026",{"header":1099,"text":1100,"button":1104,"disclaimer":1107},"Start your free\n\n30-day GitLab trial\n",[1101,1102,1103],"GitLab Duo Agent Platform access","Try our most advanced features","Automate complex tasks with AI",{"text":371,"config":1105},{"href":1106,"dataGaName":374,"dataGaLocation":615},"https://gitlab.com/-/trials/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/blog/","No credit card required.",{"header":1109,"blurb":1110,"button":1111,"secondaryButton":1116},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":1112,"config":1113},"Get your free trial",{"href":1114,"dataGaName":374,"dataGaLocation":1115},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":841,"config":1117},{"href":709,"dataGaName":379,"dataGaLocation":1115},1794911793867]