No! No! No!

[bunn]

If you are running a database with an API that other people have to connect to and pull data out of using scripts they had to write, you don't just RANDOMLY CHANGE THE FIELD STRUCTURE AND CAPITALISATION TO MAKE IT PRETTIER!

Without any notice, or information, other than just updating your own documentation, so that bunn, staring blankly at code she wrote months ago, has to go and look at the documentation, and stare as if seeking enlightenment at the data coming out of the database, to finally figure out that, oh yes, all these fields that were named like this, are now named like that!

RAAAAAAAAAAAAARGH!!!!!

Comments

[bunn.livejournal.com]

The documentation definitely does have errors in it, but on this occasion it does seem to have been updated. Unless the update is a snare and a delusion.

I have got this far by staring at the API documentation and making educated guesses. like 'well, THAT bit is true, but it would be easy to miss updating THAT bit. Let us suppose that Thing 1 is true, and Thing 2 is false, and write a thing to spit out data on that premise. Hmm. my guess at Thing 2 was wrong. How about this? Hey, that was it!

It's like solving a crossword puzzle. I am terrible at crosswords.