Definition of done: Difference between revisions

From Delft Solutions
Jump to navigation Jump to search
(Created page with "At Delft Solutions we aim to have a shared understanding what it takes to release an incremental update to one of our projects. Having a shared understanding of what it means...")
 
m (Fix format)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
At Delft Solutions we aim to have a shared understanding what it takes to release an incremental update to one of our projects. Having a shared understanding of what it means to call something **done** also means we don't have to ask "But is it _really_ done?" or "Hey you said it was done but I don't see it, where is it?".
At Delft Solutions we aim to have a shared understanding what it takes to release an incremental update to one of our projects. Having a shared understanding of what it means to call something '''done''' also means we don't have to ask "But is it ''really'' done?" or "Hey you said it was done but I don't see it, where is it?".


== Functional Requirements ==
== Functional Requirements ==


These are the _business_ requirements that emerge through conversation about a particular issue or feature, as well as the requirements listed in the issue (acceptance criteria).  
These are the ''business'' requirements that emerge through conversation about a particular issue or feature, as well as the requirements listed in the issue (acceptance criteria).  


== Quality ==
== Quality ==
Line 9: Line 9:
In order to keep the code maintainable and relatively bug-free, as well as broaden the amount of people that know about a certain feature's implementation, we expect PRs to be peer-reviewed and senior-reviewed (someone senior to the project, or, if not available, senior in the company).
In order to keep the code maintainable and relatively bug-free, as well as broaden the amount of people that know about a certain feature's implementation, we expect PRs to be peer-reviewed and senior-reviewed (someone senior to the project, or, if not available, senior in the company).


Any automated analysis that runs on a project should also be without errors. When there are warnings, it should be explained _why_ the warning isn't resolved. Yes, some of this tooling sometimes gets it wrong, but overall they make the code more consistent in style, and it often prevents a lot of common issues.
Any automated analysis that runs on a project should also be without errors. When there are warnings, it should be explained ''why'' the warning isn't resolved. Yes, some of this tooling sometimes gets it wrong, but overall they make the code more consistent in style, and it often prevents a lot of common issues.


The code must be tested. This can be a manual test or an automated test. If changes are made after the test has been performed, the test **must** be performed again.
The code must be tested. This can be a manual test or an automated test. If changes are made after the test has been performed, the test '''must''' be performed again.


== Non-Functional Requirements ==
== Non-Functional Requirements ==


- No known defects
* We make things better, not worse
- No build failures
* Build errors and warnings must be solved or explained (and accepted)
- No errors in coding standards (automated analysis)
* Existing tests passed
- Existing tests passed
* Peer code review passed
- Peer code review passed
* Deployed (if applicable)
- Deployed (if applicable)

Latest revision as of 07:03, 5 March 2021

At Delft Solutions we aim to have a shared understanding what it takes to release an incremental update to one of our projects. Having a shared understanding of what it means to call something done also means we don't have to ask "But is it really done?" or "Hey you said it was done but I don't see it, where is it?".

Functional Requirements

These are the business requirements that emerge through conversation about a particular issue or feature, as well as the requirements listed in the issue (acceptance criteria).

Quality

In order to keep the code maintainable and relatively bug-free, as well as broaden the amount of people that know about a certain feature's implementation, we expect PRs to be peer-reviewed and senior-reviewed (someone senior to the project, or, if not available, senior in the company).

Any automated analysis that runs on a project should also be without errors. When there are warnings, it should be explained why the warning isn't resolved. Yes, some of this tooling sometimes gets it wrong, but overall they make the code more consistent in style, and it often prevents a lot of common issues.

The code must be tested. This can be a manual test or an automated test. If changes are made after the test has been performed, the test must be performed again.

Non-Functional Requirements

  • We make things better, not worse
  • Build errors and warnings must be solved or explained (and accepted)
  • Existing tests passed
  • Peer code review passed
  • Deployed (if applicable)