Beefy Boxes and Bandwidth Generously Provided by pair Networks
Keep It Simple, Stupid

Re: Update module and break api, or change namespace

by eye (Chaplain)
on Dec 31, 2008 at 07:58 UTC ( #733431=note: print w/replies, xml ) Need Help??

in reply to Update module and break api, or change namespace

Should I keep things the way they are, label PDF::OCR as deprecated [...]

Even though we label things as "in development," when we release the code, we have to expect that at some point people will start to regard it as "stable." If you deprecate this module now, these people can continue to use it as long as they want. If you change the API and introduce changes that are incompatible with the old code, you create small management headaches for people that aren't prepared to or are unable to rewrite an application to use the new code base.

Moreover, if someone identifies a serious bug in the old version, how do you fix it for the people that did not upgrade? If someone else offers to maintain the "old" code, how would they be able to fix it? It's not impossible, but at best it will be horribly confusing. More likely it will make people rip their hair out and curse the day you were born.

The harm of changing the namespace is inconsequential compared with the potential harm of not changing it.

You did do the right thing. Anyone that doesn't understand that should receive a full refund of all monies that they paid you for your development efforts on PDF::OCR. They are also welcome to create a branch of PDF::OCR and do things the way they think it should be done. (Maybe they could call their branch PDF::OCR3....)

  • Comment on Re: Update module and break api, or change namespace

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://733431]
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others surveying the Monastery: (4)
As of 2018-02-18 06:07 GMT
Find Nodes?
    Voting Booth?
    When it is dark outside I am happiest to see ...

    Results (250 votes). Check out past polls.