Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options

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]
[james28909]: ok i have a new question ;)
[james28909]: i am not sure how to ask google this either
[james28909]: i am getting the current time on my machine with scalar localtime;
[james28909]: i am scraping a website and retrieving a date stamp of an article.
[james28909]: well time/data stamp of the article
[stevieb]: james28909: what's the problem/question?
[james28909]: it is not an absolute date like "27" or "31". sometimes it is like wednesday or friday
[james28909]: and i need to format those special instances into an absolute date instead of "yesterday"
[stevieb]: ask a question on SoPW, and include at least a half-dozen examples of the input, and at least one example of expected output

How do I use this? | Other CB clients
Other Users?
Others lurking in the Monastery: (6)
As of 2017-04-29 02:32 GMT
Find Nodes?
    Voting Booth?
    I'm a fool:

    Results (531 votes). Check out past polls.