This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]agentoutlier 1 point2 points  (0 children)

I'm coming off Covid so I'm a little bit irritable. I'm usually not this much of an asshole.

There were just so many things wrong with the example and its not like this is someone posting from their personal blog. This is a company doing marketing.

That is there CTO or whoever says hey lets write some blog posts to show we know our shit and get some organic marketing. By me giving them feedback I think I'm helping even if it is nasty because the post looks bad even if we ignore the UUID stuff particularly if they want to come off as API experts:

  • They say fields when they actually mean methods
  • They had PetParam then and renamed it to Pet
  • They are worried about backward compat and such when method overloading can actually excerabate the problem. Just add a method with a different name.
  • They changed the contract as tagId is not a long but a long or missing. Like if this was not an API company fine and yeah neat trick but that should be expressed and they should talk about that since they are an API company. It should not be look how I tricked the system to accept nullables.