And have I wished for lots of that unreadable code during my career. Instead I got names like timeout
and I had to go read the code (which usually means diving several classes deep), to figure out that the original developer meant optionalTimeoutInSeconds
.
That unreadable code can save users of your API lots of time. You can avoid it in your internal code if you like, but I would appreciate it if you add all this “redundant” information to your API.