I was waiting for someone with more experience in this
matter to answer your question ... but since no one has
i will share my opinion. Breaking an interface is considered
bad, unless no one was using it in the first place. At the
very least, instead of simply yanking out API calls and
replacing them with new ones, you should instead keep the
old calls and 'deprecate' them. By this you could emmit a
warning when an old API call is called, telling the module
coder to instead use the new API call. Then, after some time
has passed, you might get away with yanking out those old
The idea is to first give some an indication that certain
methods are going to go away -- just don't make the users
have to make a trip to the local planning office cellar and
have to search by torchlight for a locked filing cabinet
stuck in a disused lavatory with a sign on the door saying
"Beware of the Leopard" to find out that their favorite
API call is being demolished to make way for a new bypass. :D
(the triplet paradiddle with high-hat)
Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
Read Where should I post X? if you're not absolutely sure you're posting in the right place.
Please read these before you post! —
Posts may use any of the Perl Monks Approved HTML tags:
You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
- a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
Link using PerlMonks shortcuts! What shortcuts can I use for linking?
See Writeup Formatting Tips and other pages linked from there for more info.
| & || & |
| < || < |
| > || > |
| [ || [ |
| ] || ] ||