Live data from Hacker News

User experience design for APIs

blog.keras.io

41–44 of 44 posts

Re: User experience design for APIs

#42
post #22

Earlier quoted context omitted.

+1 Perhaps I have said this before, but UX folks have been my go-to colleagues whenever I need their inspsirations for anything ranging from graphs (like monitoring metrics) to debugging since the UX team is heavily involved from the inception of a project and sometimes have more intimate knowledge of the overall architecute of the project than the core developers do. They are amazing (of course I am talking about th…

And I have it the same way with developers. They were always my go-to colleagues more than other designers for insights and I would generally suggest to hang out with radically different perspectives than your own. Luckily, in my new company both my partner feel the same way.

Right!

Worth sharing I am a DevOps so I do production support. One night I was at the dinner table fixing some horrible issue. My sister and brother-in-law asked why I was frowning. Initially I refused to explain the situation but they convinced me to brief them the failure. They raised some questions as outsiders (one is a doctor, another is an accountant). Immediately lightbulb lighted up! Within minutes I was able to find the root cause, pushed a fix, documented the issue, and closed my laptop.

Re: User experience design for APIs

#43
post #42

Earlier quoted context omitted.

And I have it the same way with developers. They were always my go-to colleagues more than other designers for insights and I would generally suggest to hang out with radically different perspectives than your own. Luckily, in my new company both my partner feel the same way.

Right! Worth sharing I am a DevOps so I do production support. One night I was at the dinner table fixing some horrible issue. My sister and brother-in-law asked why I was frowning. Initially I refused to explain the situation but they convinced me to brief them the failure. They raised some questions as outsiders (one is a doctor, another is an accountant). Immediately lightbulb lighted up! Within minutes I was able…

Exactly

Re: User experience design for APIs

#44
post #4

Folks interested in this would probably also be interested in: * this talk by Jesse Noeller from PyTexas a few years ago: https://www.youtube.com/watch?v=-vZ_E1OO_PY * the WriteTheDocs community, which is sortof a mashup of traditional technical writers and software engineers. http://www.writethedocs.org/meetups/ * the mailing list GET PUT POST (shameless plug): https://getputpost.co/overhauling-api-docs-with-gocardl…

Related, but shameless plug, my PyCon 2017 talk "How to make a good library API" is also about the "API as UI" concept: https://www.youtube.com/watch?v=4mkFfce46zE There's also a Django-specific version called "Your Django app is a User Interface": https://www.youtube.com/watch?v=Mnzvjn1v1CY

ooh thanks!
Post reply on HN