Release Notes.... Please Note, not being released anymore

When I was 15 years old I created a Q-Basic Blackjack game. I gave it to my father to review and play with. When I gave it to him I tried to be professional and included a Readme.txt file with it. At the time I didn't know what a readme file was used for but I knew enough that every time I recieved new software it was included.

I guess part of the Ready...Set...Evolve... motto of ASI is to not only evolve iMIS but rather evolve the industry and no longer attach release notes for their new versions of iMIS. Starting with 15.0.3 the nice Release notes PDF is no more. Instead it is replaced with a link to docs.imis.com

I am not knocking docs.imis.com I think it is a great tool and resource. I am super glad they created it. Having the http://docs.imis.com site is not my issue. The mindset that http://docs.imis.com can replace the handy Release Notes PDF is my biggest beef.

Simply put the Release Notes PDF contained something very important. a list of all resolved issues. This is something http://docs.imis.com does not have. If you go to http://docs.imis.com and click on 'search issues' you are presented a page with instructions on how to navigate and use their support site. Are you kidding me? Together lets follow this procedure.

1) I go to advsol.com, login and goto Product releases.
2) I see a link that says 'Resolved Issues' . the link takes me to http://docs.imis.com
3) on the home page I click on a link that says 'Search Issues'.
4) It takes me inside the doc to a page which instructs me how to navigate the main tech support site (http://advsol.com/support)
5) I go to http://advsol.com/support and click on yet another link that says "Search Issues"
6) This page I am presented with typical search resolved issues page that we are a custom to
7) I select 15.0.3 to view all its resolved issue
8) Only found

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

Dynamic release notes

Yes, the printout was handy, but the data changes daily, which makes it a problematic publication.

Here's what everyone trips over: Many issues are resolved and found in Release Candidate versions, so you gotta choose 15.0.2xx to get the complete set of issues resolved or known in 15.0.3x. Hth!

While that is great news if

While that is great news if the issues are resolved daily the fact remains we don't see the fixes in the product until a patch is released which isn't daily.

In all honesty I don't care when an issue was resolved. I only care when the resolved issue iwas included in a patch release.

for example Casual view does not save ID in the change log for Single Instance tables. ASI might very well have it resolved today but if I have to wait for a new patch then does it matter if ASI resolved it today, tommorrow or 5 minutes before the patch was released.

I don't go check the update on all my issues on a daily basis. not sure who actually has time for that. When a new patch comes out I read the Release Notes and review the issues it has resolved. If none of the issues I have is resolved then I typically don't bother installing the patch.

I now have lost that ability.

(un)released notes

JB, you hit it on the head. We absolutely depend on the list of items fixed in each release. Fixes in internal RC releases are nice -- we're glad the product is getting fixed -- but pretty useless to those of us in the field.

Release notes are the only information we have about fixes reported by other AiSPs or discovered internally. Many times, we don't even know about a bug in a particular version until it is described in release notes for a later version. That's another sore subject, but I won't go into that now.

The point is, we already feel like we have barely enough information to help our clients. Release Notes have been our best source of information up to this point. Taking away the release notes is a big problem.

Here's how I think release notes should work.

  • If a problem was fixed anywhere between two consecutive releases (RC, GA or patch), it must be included in the release notes. (Mandatory)
  • Fixes included in Release Candidate releases need to be rolled up into the GA release notes. It's insane to review the release notes for an unsupported RC to know what has changed in the supported GA. (Mandatory)
  • Release notes for patch releases should include all fixes since the last GA. (Important and a huge time saver, but not mandatory)
  • Release notes for a new GA release should identify what patch of the previous version it is relative to. Usually this would be the last patch, but every now and then ASI releases one more patch after the new GA (timing issues or critical problems). (Important)
  • Having a place to find every fix between two arbitrary versions is a nice-to-have. We can get this by pulling the GA release notes and the latest Patch release notes for each GA. (Important)

-- Bruce

The point is we always have

The point is we always have had the 'Resolve Issue' site where we can search on and always had the 'Release Notes' PDF.

Because they co-existed for a long time. I am not really buying the argument that the 'Resolve Issues' page serves the same purpose of the 'Release Notes' PDF because if that was truly the case why did they co-exist for as long as they did.

My argument is they co-existed because they served two different purposes and functions. When one of them no longer exists. An effect to replace the functionality needs to be made.

I will be perfectly happy if the 'Resolve Issue' page was redesigned to better navigate and the description and resolution fields were cleaned up. then you can make the argument that the functionality of the 'Release Notes' PDF is now a part of the Support site.

i agree

how do we know if our issues were resolved. the release notes made if very clear.

Release notes! Yay!

I noticed that the two most recent patches for 15.0.3 (.1872 and .1987) have the PDF release notes again. Someone's listening!

-- Bruce