summaryrefslogtreecommitdiff
path: root/sifterapp/complete/states-vs-resolutions.txt
diff options
context:
space:
mode:
authorluxagraf <sng@luxagraf.net>2018-10-14 16:15:13 -0500
committerluxagraf <sng@luxagraf.net>2018-10-14 16:15:13 -0500
commit0c7dc15f893341577a88f692eade137bbcc568e3 (patch)
tree75810bda182570c5fed314291be4d4bdfa740d9f /sifterapp/complete/states-vs-resolutions.txt
initial commitHEADmaster
Diffstat (limited to 'sifterapp/complete/states-vs-resolutions.txt')
-rw-r--r--sifterapp/complete/states-vs-resolutions.txt22
1 files changed, 22 insertions, 0 deletions
diff --git a/sifterapp/complete/states-vs-resolutions.txt b/sifterapp/complete/states-vs-resolutions.txt
new file mode 100644
index 0000000..8652c81
--- /dev/null
+++ b/sifterapp/complete/states-vs-resolutions.txt
@@ -0,0 +1,22 @@
+We've written before about why Sifter has only [three possible statuses](https://sifterapp.com/blog/2012/08/the-challenges-with-custom-statuses/) -- Open/Reopened, Resolved and Closed. The short answer is that more than that over-complicates the issue tracking process without adding any real value.
+
+Why? Well, there are projects for which this will not be enough, but provided your project scope isn't quite as encompassing as say, NASA's, there's a good chance these three, in conjunction with some supplementary tools, will not only be enough, but speed up your workflow and help you close issues faster.
+
+Why are custom statuses unnecessary and how does using them over-complicate things? Much of the answer lies in how your team uses status messages -- are your statuses really describing the current state of an issue or are they trying to do more?
+
+One of the big reasons that teams often want more status possibilities is that they're using status messages for far more than just setting the status of an issue. For example, some teams use status to indicate resolutions. Probably the most common example of this is directly using resolutions as a status indicator. That is, the status of the issue is a stand-in for its outcome.
+
+How many times have you tracked down an issue in your favorite software project only to encounter a terse resolution like "working as designed" or the dreaded, "won't fix"? The problem with these statuses is that they don't describe state the issue is in, they describe the outcome. In other words they aren't statuses, they're resolutions.
+
+The status is not "won't fix", the status is closed. The *resolution* is that the issue won't be fixed.
+
+Trying to convey an outcome in a status message is like trying to fit the proverbial square peg in a round hole.
+
+Worse, in this case, you're missing an opportunity to provide a true resolution. What do you learn from these status-message "resolutions"? Nothing. What does the team working on that project learn when they revisit the issue a year from now? Nothing. That's a lost opportunity.
+
+This is part of why statuses do not make good resolutions. Resolutions are generally best captured in the description where there's room to explain a bit more about why you aren't going to fix something. Take a minute to explain why you aren't going to fix something or why it's designed the way it is and your users will thank you.
+
+Perhaps even more important, your future self will thank you when the same issue comes up again and you can refer back to your quick notes in the resolution to see why things are the way they are.
+
+Provided you use status messages solely for setting the status of an issue then there's rarely a need for more statuses than those Sifter offers -- Open, Resolved and Closed.
+