[Insight-developers] Backward Compatibility
Stephen Aylward
Stephen.Aylward at Kitware.com
Tue May 13 07:30:20 EDT 2008
I was referring to his comments on Bug:
# 0006558 (http://www.itk.org/Bug/view.php?id=6558)
Sorry if there was confusion.
Stephen
On Tue, May 13, 2008 at 7:29 AM, Stephen Aylward
<Stephen.Aylward at kitware.com> wrote:
> This may be a situation where we create a new function that performs
> the operation correctly, and we begin to deprecate the old function.
>
> It is highly likely that someone in the world has also discovered this
> feature and developed a work-around in their code. If we change it,
> we will break their code, i.e., WE will create a bug in their code
> that would be extremely difficult for them to detect and potentially
> critical to the output they produce.
>
> The new function name should be more explicit of the operation it performs:
>
> TransformPhysicalPointToCenteredIndex ?
> TransformPhysicalPointToRoundedIndex ?
>
> etc
>
> That's my suggestion.
>
> Stephen
>
>
>
> On Tue, May 13, 2008 at 5:16 AM, Andreas Keil <andreas.keil at cs.tum.edu> wrote:
> > Dear ITK developers,
> >
> > triggered by the "adopt a bug program" - I consider getting more involved
> > in ITK. For this reason, I kindly ask you to point me to ITK's backward
> > compatibility policy. So far, I found the sources mentioned at
> > http://www.itk.org/Wiki/ITK_Policies_and_Procedures which tell me that
> > this issue is still an open discussion. I am still wondering how strictly
> > backward compatibility is enforced, i.e. in which cases backward
> > compatibility is allowed to be broken. (I mean, there must be cases where
> > it may be broken, e.g. when fixing severe bugs.)
> > I am specifically wondering about the following two bugs I reported:
> >
> > # 0004560 (http://www.itk.org/Bug/view.php?id=4560)
> > Here, I would vote for reopening the issue and throwing exceptions
> > whenever one of the Set... methods is called with the parameter i out of
> > bounds. Throwing an error here would not really change ITK's behaviour. It
> > would only change the exception handling which is anyways only performed
> > in case a user used the class incorrectly. If I were such a user, I would
> > be glad to have a changed behaviour here, wouldn't I?
> >
> > # 0006558 (http://www.itk.org/Bug/view.php?id=6558)
> > In the case of this so far unattended but IMHO really severe bug, every
> > fix would change behaviour since the current implementation is plain
> > wrong. I would have volunteered to work on a fix. However, I don't feel
> > experienced enough to work on this bug which is located in the heart of
> > ITK - the ImageBase class, esp. since it requires changing ITK's
> > behaviour.
> >
> > Looking forward to your comments,
> > Andreas.
> >
> >
> >
> > -----Original Message-----
> > From: insight-users-bounces at itk.org [mailto:insight-users-bounces at itk.org]
> > On Behalf Of Luis Ibanez
> > Sent: Thursday, May 08, 2008 04:25
> > To: Insight Users
> > Subject: [Insight-users] PROGRAM ANNOUNCEMENT: "ADOPT A BUG"
> >
> >
> >
> >
> > Our bugs are feeling sad and lonely
> > due to lack of attention.
> >
> >
> >
> >
> > We have decided to give them out for adoption.
> >
> >
> >
> >
> > Join now the "Adopt a Bug" program,
> > and help us make ITK a more
> > useful and reliable toolkit.
> >
> >
> >
> >
> > As you probably have heard from recent posts to the mailing list,
> > ITK is in need of a *bug purification campaign*. We have a collection
> > of bugs that have been lingering for quite a while, and some of
> > them even have fixes proposed by the bug reporters.
> >
> >
> > In order to tackle this challenge, we would like to engage the
> > *collective intelligence* of the users community.
> >
> >
> > One of the strongest assets of Open Source is the enormous potential of
> > the large number of users that can make small localized contributions.
> >
> > The cumulative effect of those contributions can not possibly be matched
> > by a traditional organization. There is no way that the developers team
> > could ever compete with the aggregated brain power of more than 1500
> > well-educated users currently subscribed to the mailing list.
> >
> >
> >
> > We are looking for courageous users willing to contribute some hours
> > of their time to ensure that our bugs receive the care that they
> > deserve.
> >
> >
> >
> > By adopting any of our dearest 257 open bugs, you will commit to
> > take the steps needed for making sure that your adopted bug gets
> > fixed before the release of ITK 3.8.
> >
> >
> >
> > We care about our bugs and therefore we will not simply give them
> > away to strangers. Bug adoptive parents should satisfy the following
> > requirements:
> >
> >
> > 1) Have good C++ skills
> >
> >
> > 2) Adhere to the Dashboard quality practices
> >
> >
> > 3) Subscribe to the following strong parental attitude:
> >
> > "If you guys don't fix it, I will fix it"
> >
> >
> > 4) Respect the backward compatibility policy
> >
> >
> >
> >
> > As a participant in the "Adopt a Bug" program you will receive CVS write
> > access to the ITK repository and you will be entitled to commit bug
> > fixes by yourself. You will be encouraged to work with other developers
> > in finding consensus on the best way to fix a bug.
> >
> >
> >
> > As ITK users you probably will be interested in a particular bug
> > that may be making difficult for you to get your project done.
> > That one will probably be the best bug for you to adopt since you
> > will be directly interested in getting that bug fixed as soon
> > as possible.
> >
> >
> >
> > Please join the "Adopt a Bug" program today
> > and help make ITK a better place to program.
> >
> > Pick your Bug now at:
> >
> > http://public.kitware.com/Bug
> >
> >
> > and send us email so that we can take care
> > of the adoption paperwork.
> >
> >
> >
> >
> > Thanks
> >
> >
> > Luis
> >
> > _______________________________________________
> > Insight-developers mailing list
> > Insight-developers at itk.org
> > http://www.itk.org/mailman/listinfo/insight-developers
> >
>
>
>
> --
> Stephen R. Aylward, Ph.D.
> Chief Medical Scientist
> Kitware, Inc. - Chapel Hill Office
> http://www.kitware.com
> (518) 371-3971 x300
>
--
Stephen R. Aylward, Ph.D.
Chief Medical Scientist
Kitware, Inc. - Chapel Hill Office
http://www.kitware.com
(518) 371-3971 x300
More information about the Insight-developers
mailing list