---
title: "Design Documents"
permalink: design-docs-index.html
hide_sidebar: true
hide_navtoggle: true
toc: false
folder: design-docs
---

Gerrit follows a design-driven contribution process for larger/complex features described
[here](https://gerrit-review.googlesource.com/Documentation/dev-contributing.html#design-driven-contribution-process).

This section houses design documents that were written prior to a system refactoring or the
introduction of a new feature.
The list is sorted by recency and links to individual design documents. Review and vetting of the
documents can be found in Gerrit by using the link inside each doc.

## List of Design Documents

- [WIP workflow](https://gerrit-review.googlesource.com/c/homepage/+/106892/2/docs/WipProposal.md) by Logan Hanks, proposed 2017-12-05
- [Gerrit CI/analyzer integration - Workflow/API](https://docs.google.com/document/d/e/2PACX-1vRW41XdoY-HlKdgSzAZ4Dwm-OeAyi1zEkDvwIfw3FsZ5H4yhtPNaZPs-50lgG_BHsWLKixxlrHpske1/pub) by Alice Kober-Sotzek, proposed 2019-02-13
- [Generate Release Notes](design-docs/generate-release-notes.html) by Edwin Kempin, proposed 2019-10-04
- [Revert submit](design-docs/revert-submit.html) by Gal Paikin, approved 2019-09-09
- [Scaling Multi-Master Replication](design-docs/scaling-multi-master-replication.html) by Martin Fick, approved 2019-11-12
- [Attention Set](design-docs/attention-set.html) by Ben Rohlfs, approved 2020-01-03
- [Change Log: Threaded Feedback](design-docs/change-log-threaded-feedback.html) by Jacek Centkowski, approved 2020-03-25
- [Instance Id](design-docs/instance-id.html) by Fabio Ponciroli, approved 2020-05-05
- [Checks UI - CI Reboot](design-docs/ci-reboot.html) by Ben Rohlfs, approved 2020-08-20
- [Deletion of Groups](design-docs/delete-groups.html) by Gal Paikin / Jacek Centkowski, approved as plugin 2020-09-01
- [Case Insensitive Username Matching](design-docs/case-insensitive-username-matching.html) by Thomas Draebing, proposed 2021-03-18
- [Push Reviews](design-docs/push-reviews.html) by Edwin Kempin, proposed 2022-03-04
- [Support posting changes from Jujutsu](design-docs/support-jujutsu.html) by Edwin Kempin, proposed 2025-04-01

## Reviews of Design Documents

- [in review](https://gerrit-review.googlesource.com/q/project:homepage+dir:%2522pages/design-docs%2522+status:open)
- [submitted](https://gerrit-review.googlesource.com/q/project:homepage+dir:%2522pages/design-docs%2522+status:merged)
- [abandoned](https://gerrit-review.googlesource.com/q/project:homepage+dir:%2522pages/design-docs%2522+status:abandoned)