{"id":3352,"date":"2014-07-16T23:45:26","date_gmt":"2014-07-16T13:45:26","guid":{"rendered":"http:\/\/www.vectorstorm.org\/?p=3352"},"modified":"2014-07-16T23:45:58","modified_gmt":"2014-07-16T13:45:58","slug":"post-mortem-on-milestone-5","status":"publish","type":"post","link":"https:\/\/www.vectorstorm.com.au\/2014\/07\/16\/post-mortem-on-milestone-5\/","title":{"rendered":"Post-Mortem on Milestone 5"},"content":{"rendered":"<p>In the days after Milestone 5, I&#8217;m working on laying out my plans for Milestone 6. This is a bigger milestone than usual. I&#8217;m not yet quite sure how big, but it&#8217;s definitely going to take longer than the two weeks for Milestone 5.<\/p>\n<p>But first, I want to look back on the last two weeks and evaluate what went well, and what didn&#8217;t, so I can handle future milestones more effectively.<!--more--><\/p>\n<p>First things first;  the obvious &#8220;what went wrong&#8221;:  Back in Milestone 4, I accidentally released a Mac build which had been compiled in debug mode.  That mistake finally convinced me to write a script which creates the Mac milestone builds automatically, without any human steps being taken.  I did the same for the Windows builds, mostly, but there were still a few human steps involved, which were simple enough that I didn&#8217;t bother to figure out how to make those scripts absolutely bulletproof.  As a result of those incomplete build scripts on Windows, in Milestone 5, I accidentally released a Windows build which contained the data files from the Milestone 4 build.  Predictable, really.<\/p>\n<p>So the first thing I did after uploading a fixed Windows build was to fix the Windows build scripts.  Now, like the Mac build script, the creation of a milestone build is completely automated, and builds completely from scratch &#8212; no human intervention required, no chance of accidentally including an old, no-longer-relevant file.  I should have done this before, but..<\/p>\n<p>With that out of the way, let&#8217;s talk about how Milestone 5 went, other than that.<\/p>\n<h1>What went right<\/h1>\n<ul>\n<li>I like the shorter development cycle;  it felt like there was a lot more pressure to get things done in a timely manner.  By comparison, Milestone 4 (January -> June) seemed to drag on forever.. although much of that was before I went full-time on MMORPG Tycoon 2.  It seems to me like the right milestone duration is probably around a month.  Maybe up to two.  Maybe I need to continue to produce regular public builds, even outside of the milestone schedule, just to keep myself honest.  Would there be interest in more frequent builds, instead of only getting them at the milestones?<\/li>\n<li>Mostly had a design for the new features right up front.  The general functionality of the quest panes (drag up\/down to reorder, and off of their window to destroy them) was unchanged for the whole duration of the milestone.  The method to edit quests was much later, and ended up being a real hack.  Don&#8217;t get me wrong;  it works, and I like the way the UI feels.  But making it work was surprisingly complicated.<\/li>\n<li>Focus on &#8220;make it work&#8221; rather than &#8220;make the code beautiful&#8221;.  This came from the shorter development cycle.  In the MS5 build, there are basically two separate implementations for buttons which can be dragged around into different slots;  there&#8217;s the one for the new quest buttons, and one for the action bar buttons.  When it occurred to me that I&#8217;d already implemented something that handled dragging of buttons, I thought about trying to make that functionality generic, and driving both sets of buttons from one set of logic.. but in order to be anywhere near the milestone deadline, I decided to implement the generic functionality, but not to spend the time modifying the action bar buttons to use the new generic functionality.  I can still do that later, if necessary, but it wouldn&#8217;t have delivered any real benefits for MS5.<\/li>\n<li>Ignoring the exact placement of the info panel, I really like the system I eventually settled upon for aggregating content to go into the panel.  It&#8217;s extremely flexible, and has some useful built-in layout tools which allow different types of data to be formatted together nicely.<\/li>\n<\/ul>\n<h1>What went wrong<\/h1>\n<ul>\n<li>See comments above, RE: the first Windows build which had the wrong data files.<\/li>\n<li>Info panel design paralysis.  I went through four different designs for the info panel during the Milestone 5 time.  Originally, it was in a floating window.  Then, it was in a HUD panel on the left side of the screen.  Then, it was in the middle on the right.  Then in the top right.  I still think it&#8217;s in the wrong place.  For a while, I thought that it should replace the context matrix, but obviously the quest editing wouldn&#8217;t fit into so small an area.  I still think that needing to click the little &#8220;Info&#8221; command to show the info panel is completely the wrong interface;  it should show up automatically when an object is selected &#8212; I&#8217;m just not sure <strong>where<\/strong> it should show up automatically.<\/li>\n<li>Lots of &#8220;design days&#8221;, where nothing concrete was accomplished.  Largely due to the above design paralysis, I spent about ten days on the info panel, but only about three days on the quest editing itself &#8212; the quest editing which was supposed to have been the whole point of the milestone build.<\/li>\n<li>No support for editable values in the info panel.  I really wanted, for example, to be able to rename a region, or change its color, or etc.  But due to the number of times I threw away work on the info panel, I never quite had the time to add actually add support for editable values.  (Although some of the functionality I added for the quest editing could be adapted, in future builds)<\/li>\n<li>On this very short timeline milestone, I spent a few days fixing bugs from Milestone 4, including crashes from placing roads and etc.  Maybe I shouldn&#8217;t have put those sorts of bugfixes into the same timeline for adding new features?  I don&#8217;t know.  They take basically the same time no matter where I put them, so maybe it doesn&#8217;t matter.<\/li>\n<\/ul>\n<p>Really, the big surprise takeaway from MS5 for me is how much I like this shorter duration between deadlines.  If folks are interested, I might start doing public builds every two weeks, or every month, regardless of whether or not there&#8217;s a full &#8220;milestone&#8221;.<\/p>\n<p>Anyone have thoughts?<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In the days after Milestone 5, I&#8217;m working on laying out my plans for Milestone 6. This is a bigger milestone than usual. I&#8217;m not yet quite sure how big, but it&#8217;s definitely going to take longer than the two weeks for Milestone 5. But first, I want to look back on the last two&hellip;<\/p>\n","protected":false},"author":1,"featured_media":2679,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spay_email":""},"categories":[24,25],"tags":[],"jetpack_featured_media_url":"https:\/\/www.vectorstorm.com.au\/wp-content\/uploads\/2013\/01\/blahblahblah.png","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/po9WK-S4","_links":{"self":[{"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/posts\/3352"}],"collection":[{"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/comments?post=3352"}],"version-history":[{"count":5,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/posts\/3352\/revisions"}],"predecessor-version":[{"id":3357,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/posts\/3352\/revisions\/3357"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/media\/2679"}],"wp:attachment":[{"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/media?parent=3352"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/categories?post=3352"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.vectorstorm.com.au\/wp-json\/wp\/v2\/tags?post=3352"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}