<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Lex Neva's thoughts &#187; JIRA</title>
	<atom:link href="http://www.lexneva.name/blog/category/jira/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.lexneva.name/blog</link>
	<description>blog of Lex Neva in Second Life</description>
	<lastBuildDate>Thu, 12 Jun 2008 18:29:49 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.8.4</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>JIRA drama</title>
		<link>http://www.lexneva.name/blog/2007/11/25/jira-drama/</link>
		<comments>http://www.lexneva.name/blog/2007/11/25/jira-drama/#comments</comments>
		<pubDate>Sun, 25 Nov 2007 22:07:02 +0000</pubDate>
		<dc:creator>lex</dc:creator>
				<category><![CDATA[JIRA]]></category>

		<guid isPermaLink="false">http://www.lexneva.name/blog/2007/11/25/jira-drama/</guid>
		<description><![CDATA[Apparently I was the catalyst of some major JIRA drama.
For those new to the game, JIRA is a product by Atlassian that helps software developers keep track of a monstrously huge pile of bug reports and feature requests.  It helps organize issues in relation to each other so that the huge pile of information [...]]]></description>
			<content:encoded><![CDATA[<p>Apparently I was the catalyst of some major JIRA drama.</p>
<p>For those new to the game, <a href="http://www.atlassian.com/software/jira/">JIRA</a> is a product by Atlassian that helps software developers keep track of a monstrously huge pile of bug reports and feature requests.  It helps organize issues in relation to each other so that the huge pile of information can be presented in an intelligible manner.</p>
<p>Linden Lab has used JIRA internally for a long time, and this year, with the advent of their open source client, they opened a new instance of JIRA to the SL public, called the &#8220;Public JIRA&#8221; or &#8220;PJIRA&#8221;.  It&#8217;s for us in the community to track issues that affect SL, provide technical information, and help fellow residents by providing more information on the bugs they report.  It&#8217;s a HUGE step forward in allowing the community to communicate with LL, and I really want to see it succeed.  Before this, all we had was the Bug Report black box, and we had no idea if LL had even read what we reported.</p>
<p><span id="more-8"></span></p>
<h2>Drama Ensues</h2>
<p>There are two points to making the JIRA public: to allow communication between LL and residents about bugs to be public, and to allow residents to <i>collaborate</i> on bug reports, thereby enriching them.  It&#8217;s that latter that causes the most drama.</p>
<p>Here&#8217;s what happened:</p>
<ul>
<li>Prokofy Neva reported <a href="http://jira.secondlife.com/browse/VWR-3071">VWR-3071</a>.</li>
<li>I commented on the report, giving my opinions on the matter.</li>
<li>Separately from that, I also resolved the issue as per LL&#8217;s <a href="https://wiki.secondlife.com/wiki/Issue_tracker">Issue Posting Guidelines</a>, pointing out that the issue should be reclassified as a feature request.</li>
<li>Prokofy went nuts because I &#8220;unilaterally closed&#8221; his issue.  He reopened it.</li>
<li>Prokofy opened <a href="http://jira.secondlife.com/browse/MISC-799">MISC-799</a>, a thinly veiled attack on my action in the guise of a request not to allow me or others to ever modify Prokofy&#8217;s issues.</li>
<li>I pointed out the link to VWR-3071, and also moved the issue to its proper classification, WEB-382, since it was an issue about jira.secondlife.com.</li>
<li>Drama ensued.</li>
<li>I did my best to provide justification for my actions, and then I ducked out of the thread because I&#8217;ve learned in the past that it&#8217;s just not possible to out-talk Prokofy.</li>
<li>The issue was addressed in the <a href="https://wiki.secondlife.com/wiki/Bug_triage/2007-11-19">2007/11/19 Bug triage</a>.  See <a href="https://wiki.secondlife.com/wiki/Bug_triage/2007-11-19/Transcript">transcript</a>, starting around [12:15].</li>
<li>That leads us up to now: The Lindens have decided to ask Prokofy for examples of abuses in JIRA that have caused problems; read <a href="http://jira.secondlife.com/browse/WEB-382#action_34433">this</a>, <a href="http://jira.secondlife.com/browse/WEB-382#action_34440">this</a>, and <a href="http://jira.secondlife.com/browse/WEB-382#action_35179">this</a> if you&#8217;re interested in those examples.</li>
</ul>
<h2>Collaborative Editing and Accountability</h2>
<p>My strongest feeling through all of this is frustration with Prokofy&#8217;s notion of &#8220;unilateral action&#8221;.  He seems to feel that my &#8220;closing&#8221; of VWR-3071 constituted a unilateral decision to silence his speech, which it wasn&#8217;t.  The <a href="https://wiki.secondlife.com/wiki/Issue_tracker">Issue Posting Guidelines</a> make it pretty clear that &#8220;resolving&#8221; an issue, especially for resolutions like &#8220;Needs More Information&#8221; is to be taken as a direct request that the author take more action and then reopen the issue if appropriate.  In my <a href="http://jira.secondlife.com/browse/VWR-3071#action_33000">comment</a> at the time I resolved VWR-3071, I even gave an example of what Prokofy could do to fix the issue, which is considered good practice.</p>
<p>The thing is, even if I was wrong, the right thing to do would be to reverse my action.  Simply reopen the issue and no harm&#8217;s done.  I&#8217;m perfectly willing to hear that I&#8217;ve done something wrong, or that the rest of the community doesn&#8217;t agree with what I&#8217;ve done.  If we had to run around getting votes from everyone in the community or approval of the reporter of an issue before the issue could be modified, then we&#8217;d never get anything done.  On the other hand, if we leave things open, but keep track of everything everyone does, there&#8217;s a strong incentive to make sure that you&#8217;re NOT acting with impunity, because doing so will only result in your changes being reverted and your reputation suffering.</p>
<p>That&#8217;s the key here: this JIRA, like Wikipedia and many other collaborate projects, work on a theory that many people, working loosely and with little organization, can together shape something that&#8217;s bigger and better than anyone can do on their own.  LL is simply too small a company to individually police the flood of JIRA issues (many of them inappropriate or filed in the wrong place) and shape it into a useful body of information.  There&#8217;s just <i>too much information</i> for any one person to handle.  We could try to elect a &#8220;president&#8221; of JIRA who we all were happy with and trusted to manage all issues, but the result would be unsatisfying.  It&#8217;d be impossible to find such a &#8220;president&#8221; that everyone would be happy with, and even if we did, there&#8217;s just WAY too much information for one person to handle.  The fact is that one vision can&#8217;t succeed.</p>
<p>Democracy can&#8217;t, either.  We can&#8217;t make JIRA democratic, for the reason I stated above: we&#8217;d tie our own wrists.  There&#8217;s just too much to be done, and voting takes too long.  Nothing would ever get done.  JIRA would topple in a mess of beauracracy.</p>
<p>The solution we&#8217;re trying now is collaboration.  It&#8217;s just like how ants work: scientists are pretty clear on the fact that no one ant has any concept of the structure of the anthill as a whole, not even the queen.  Instead, they have basic rules about how they&#8217;re supposed to act, and the result of getting a lot of ants together following those rules is that an anthill is created.  Scientists would say the anthill &#8220;emerges&#8221;.</p>
<p>The idea is that we all do a little work here and there, making changes as we see fit, in order to move JIRA as a whole one small increment toward greatness.  What about rogue elements?  Well, just like in the body, where cancer cells are eliminated on a regular basis, rogue elements in JIRA are quickly subverted by the will of the community as a whole.  I could run around closing issues I don&#8217;t like, and 20 other JIRA users will run around just behind me, reopening them and building a consensus that I&#8217;m being a jerk.  Pretty soon I&#8217;ll find myself kicked out of the pool.  It&#8217;s a pretty good system.</p>
<p>The problem is that Prokofy doesn&#8217;t agree with the community that runs JIRA, as a whole.  He has said over and over that JIRA is frequented by a &#8220;cabal&#8221; of users that think we speak for the community as a whole, when in fact we&#8217;re just speaking for our own bloc.  While I feel that JIRA is egalitarian because any SL user can wander over and make changes as they see fit, Prokofy feels that we regular users (&#8220;lifers&#8221;) occupy a privileged place in the SL community because of the time we devote to JIRA.  His feeling is that, by spending hours a day on JIRA, we see our opinions gain an unfair weight because we&#8217;re exercising them so often.  And he also seems to feel that only a <i>certain kind of person</i> (ie the &#8220;techie crowd&#8221;) will spend this much time in JIRA, so only a <i>certain kind of opinion</i> will shape JIRA.  It&#8217;s like a <a href="http://en.wikipedia.org/wiki/Voting_bloc">voting bloc</a>.  [Note: Prokofy, if I&#8217;ve unfairly stated your opinion here, let me know.]</p>
<p>It&#8217;s a fair criticism, and I admit that it&#8217;s a possibility in a system like this.  However, I don&#8217;t think it applies in this case.  Generally, I try to act in as unbiased a manner as possible, and give reasons and suggested actions when I change or resolve an issue.  When I&#8217;m not sure I should make a given action, I propose it in a comment rather than doing it immediatley.  I haven&#8217;t done these things enough in the past, and I&#8217;m going to do them more in the future in hopes that I can avoid the kind of drama we&#8217;re seeing now.  I also don&#8217;t think the users of JIRA are exercising any kind of groupthink.  There are widely disparate elements that are frequently seen in JIRA, and these people regularly face me head-on and disagree with me.  I appreciate it.  It helps me do a better job in the future.  Thanks, Mercia McMahon!</p>
<p>While I agree that Prokofy&#8217;s theory is a possibility, I don&#8217;t think that merely stating the fact makes it true.  It&#8217;s fairly clear to me that Prokofy likes to build up theories of secret cabals of people that are out to influence Second Life to their own selfish ends while ignoring the good of the community as a whole.  I don&#8217;t think such cabals really exist; rather, Prokofy has a hard time understanding that what is obviously correct to him may not be how everyone else feels.  He builds theories of secret cabals to explain why people act the way they do, rather than understand that maybe what he takes to be a fact is just his opinion.</p>
<p>There&#8217;s just one way that the JIRA system does filter who uses it, and that&#8217;s the interface.  This is a tough problem.  The fact is that there are many issue trackers out there, and that the vast majority of them just aren&#8217;t up to the task of organizing such a vast body of knowledge as that seen in LL&#8217;s PJIRA.  The JIRA tool helps us perform critically important tasks such as linking issues together as related or as duplicate issues, searching for and categorizing issues based on myriad criteria, and facilitating voting and discussion.  I&#8217;ve used a lot of issue trackers in the past, and JIRA is hands down the best tool for the job.  Without it, we&#8217;d spend way more time trying to organize information, and way less time actually doing useful work on concrete issues.  In short, without JIRA, we&#8217;d waste a ton of time.</p>
<p>On the other hand, JIRA is, by its nature, geared toward technical users.  It works GREAT for us.  It&#8217;s designed by technical people, for technical people.  It does exactly what we want in a way that makes sense to us.  The problem is that this runs straight up into the first principle of User Interface design that I learned in college: &#8220;<strong>You are not normal</strong>&#8221;.  In short, when designing a user interface, what the programmer likes is very likely not to make a bit of sense for non-programmers.  This explains why a vast majority of computer interfaces are still horrible for most users, and why computers are hard to use for many people.</p>
<p>So the problem is that the JIRA interface itself acts as a filter on who can use it.  This sucks, because it&#8217;s such a useful tool otherwise.  Where Prokofy and I disagree is in what should be done about this.  He thinks that everyone should be limited from using PJIRA so that the playing field is levelled.  I think that LL should do a ton more work to simplify the interface presented to PJIRA users so that they are better able to participate.  Prokofy&#8217;s method means that we lose all of the progress we&#8217;ve gained so far.  Mine means that we keep all of our current progress and gain much more from all of the new users with different backgrounds.</p>
<p>Until then, it&#8217;s up to us who easily understand JIRA to reach out to those in the community.  Provide links to important issues in forums outside of JIRA.  Explain to people that logging in and voting is important, and commenting is useful as well.  INCLUDE people.  Remember that <strong>you are not normal</strong>.</p>
<p>That said, I hope that the rest of the community realizes that I&#8217;m not some kind of tech-minded automaton.  I&#8217;m highly technical, but I&#8217;m also very concerned about social and economic issues in SL.  I make my entire living in SL.  It&#8217;s in my interests not to bury economic issues in JIRA.  And I don&#8217;t spend my life in JIRA.  I spend about 20-40 minutes on average per day, and I do it because I like to keep track of new issues in JIRA that might affect my business and my job.  I clean things up while I&#8217;m there because it&#8217;s a little bit that I can do to help out.  I definitely don&#8217;t have hours a day to spend on this stuff.</p>
<h2>Open Letter</h2>
<p>Well, I just said way more than I thought I was going to say.  The problem with Prokofy and me is that we both have very forceful personalities, and we both type a heck of a lot.  I&#8217;m the kind of person that wants to call people on their bullshit, and won&#8217;t back down just because someone else says really hard that they&#8217;re right.  Going head to head would be a scary thing, because Prokofy and I would probably never stop talking.  We both care a heck of a lot about SL.  I&#8217;m doing my best to avoid getting in an outright flamewar with him, because I know no one will win.  I feel a deep need to counter and address many of the thing he&#8217;s said, so I&#8217;m using my blog as an outlet.</p>
<p>I also wrote to Rob Lanphier (head of open source stuff at LL and, I believe, a fairly major authority on PJIRA) in response to the discussion during the bug triage.  I ended up saying a lot of things that were on my mind, and I think this stuff might be interesting to the rest of the community outside of LL, so in parting, I&#8217;ll leave you with what I wrote:</p>
<blockquote><p>Rob,</p>
<p>I just had a chance to check the transcript of the latest bug triage for the discussion about WEB-382 (Prokofy&#8217;s crusade).  I can&#8217;t help but feel a little responsible for Prokofy&#8217;s tirade because it was my action in VWR-3071 that set him off, but I suppose it would have happened eventually the moment anyone touched one of his issues.</p>
<p>I&#8217;m sorry that I wasn&#8217;t able to make it to that triage, and that I generally am not able to devote the time to triages and email lists.  I spend 20-40 minutes a day checking JIRA, just to keep up on the latest bugs affecting the grid, and I clean up while I&#8217;m at it.  I think that even that contribution is pretty helpful, because between us &#8220;JIRA cleaners&#8221;, we sweep out a lot of cruft.  BUT, if I&#8217;m doing anything wrong, making any unilateral actions I shouldn&#8217;t, I want to know, and I&#8217;ll be glad to change or stop what I&#8217;m doing. I&#8217;m just trying to contribute to making JIRA actually useful.</p>
<p>In regards to the triage, one of the suggestions was to limit closing/resolving issues to people deputized by LL (probably &#8220;good-citizens&#8221;). It looks like this proposal was tabled, but just in case, I want to put in my two cents.  I really don&#8217;t think you should do that.  As someone pointed out, ANYONE deputized by LL will not satisfy Prokofy, and he will see it as a list of people to villify and as evidence of his &#8220;secret cabal&#8221; of people ruining SL.  It won&#8217;t help at all.</p>
<p>As to the actual issue at hand (whether open issue modification rights cause abuse), I haven&#8217;t seen any abuse or improper actions in JIRA that were not quickly reversed.  Sometimes an action is reversed by the original reporter, but often enough someone else in the community does it.  Actual abuses that need to be reverted are very rare, and I&#8217;ve NEVER seen an unchecked &#8220;revert war&#8221; where two people argued by repeatedly undoing and redoing each other&#8217;s actions.  It just hasn&#8217;t happened.</p>
<p>Prokofy seems not to understand what JIRA is for.  I see it as a tool to help the community speak with a voice that&#8217;s actually useful to LL with regard to what bugs exist in the world.  There&#8217;re so many that it&#8217;s just not as obvious as someone like Prokofy thinks it is to list them all, much less fix them all.</p>
<p>Prokofy seems to want to use JIRA as a weapon to force LL to change to suit his whims, or at least to use as ammunition in his never-ending battle against LL.  He seems to want to be able to report an issue and keep it open even if LL doesn&#8217;t agree with it, so that he can say &#8220;Look, the Lindens aren&#8217;t listening to Us!&#8221;  This is not to say that I think LL always listens perfectly to what the community says, or that I&#8217;m an unswaying &#8220;LL fangirl&#8221;; I&#8217;m just of the opinion that JIRA is not a good forum for this kind of thing.  It&#8217;s not a soap-box.  It&#8217;s not a wall outside at LL HQ where we can paste our grievances so that the world can see how horrible LL is.  It&#8217;s for providing LL useful information, not for ranting.</p>
<p>The Triage decision was to ask Prokofy to provide examples of issues in which &#8220;unilateral&#8221; action caused damage.  My action in VWR-3071, of course, is one of those examples, and while I think what I did was defensible, I&#8217;m certainly willing to listen to the fact that I may have acted incorrectly.</p>
<p>However, most of Prokofy&#8217;s other current examples were either resolved by a Linden or by the issue reporter.  It seems that he doesn&#8217;t want to allow even Lindens to close issues.  He doesn&#8217;t trust any Lindens at all.  With that in mind, I don&#8217;t think JIRA&#8217;s going to be particularly useful to him at all.</p>
<p>With all of this said, I think there&#8217;s one useful change that should come out of this.  It should be made much more clear what LL&#8217;s policy on JIRA is. I&#8217;ve had plenty of situations where I acted according to the JIRA usage guidelines and people were upset because &#8220;some random person not approved by Linden Lab is changing my issue&#8221;.  I think it needs to be made much more clear what LL wants people to do, what their recourse should be when they feel someone acted inappropriately on JIRA (and reverting the change doesn&#8217;t settle the conflict).</p>
<p>More specific to VWR-3071, I think there should be a much more clear definition of whether an issue should be a bug report or a feature request. My feeling is that the definition should be something like, &#8220;a bug is when the system does not function as designed&#8221;, whereas &#8220;a feature request is when the system works as designed, but you want the design changed&#8221;.  Also, it should be made clear where policy change requests go, if they belong in JIRA at all. Furthermore, Prokofy&#8217;s main problem with my action was that I &#8220;closed&#8221; his issue and am therefore an tyrant.  The JIRA policy guidelines already say that a resolution is NOT the same as closing an issue, but this needs to be made much more clear.</p>
<p>Finally, I think the priorities should be more clearly spelled out, with distinct examples of types of issues that belong in each category, and perhaps with concrete examples of properly-prioritized issues.  That, or we should completely do away with the priority system.  So many people become personally upset when their issue, which drastically impacts their ability to play SL (but no one else&#8217;s) is reduced from &#8220;Showstopper&#8221; to &#8220;Normal&#8221;.  If I&#8217;m the one that makes that change, they feel like I&#8217;m telling them their issue isn&#8217;t important.  I&#8217;d love it if I could direct them to a more comprehensive explanation of issue priorities than already exists.  And while I&#8217;m on the subject, I think that the explanation of priorities needs to also include descriptions of priorities for Feature Request proposals, because the current priority descriptions don&#8217;t apply very well to feature requests.
</p></blockquote>
]]></content:encoded>
			<wfw:commentRss>http://www.lexneva.name/blog/2007/11/25/jira-drama/feed/</wfw:commentRss>
		<slash:comments>9</slash:comments>
		</item>
	</channel>
</rss>
