Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Turks, Aliens and Thinking

Z
September 08, 2016

Turks, Aliens and Thinking

Z

September 08, 2016
Tweet

More Decks by Z

Other Decks in Technology

Transcript

  1. Memorandum For Members and Affiliates of the Intergalactic Computer Network

    Consider the situation in which several different centers are netted together, each center being highly individualistic and having its own special language and its own special way of doing things. Is it not desirable, or even necessary for all the centers to agree upon some language or, at least, upon some conventions for asking such questions as “What language do you speak?” At this extreme, the problem is essentially the one discussed by science fiction writers: “how do you get communications started among totally uncorrelated 'sapient' beings?.”
  2. OR?

  3. SHARED UNDERSTANDING AHEAD OF TIME 1 A component exposes an

    interface 2 Some humans write a lot of text to document it
  4. SHARED UNDERSTANDING AHEAD OF TIME 1 A component exposes an

    interface 2 Some humans write a lot of text to document it 3 Some other humans read it
  5. SHARED UNDERSTANDING AHEAD OF TIME 1 A component exposes an

    interface 2 Some humans write a lot of text to document it 3 Some other humans read it 4 And program another component to use the interface
  6. API

  7. SHARED UNDERSTANDING AHEAD OF TIME 1 EX PO SE IN

    TERFAC E W RITE D O C S REA D D O C S PRO G RA M C LIEN T 2 3 4
  8. SHARED UNDERSTANDING AHEAD OF TIME 1 EX PO SE IN

    TERFAC E W RITE D O C S REA D D O C S PRO G RA M C LIEN T 2 3 4
  9. SHARED UNDERSTANDING AHEAD OF TIME 1 EX PO SE IN

    TERFAC E W RITE D O C S REA D D O C S PRO G RA M C LIEN T 2 3 4 what happens when one of these changes?
  10. PROBLEMS OF SHARED UNDERSTANDING AHEAD OF TIME • Error-prone •

    Brittle system • Tight-coupling, prohibits changes • Requires couple of iterations to get it right • Does not scale humans do errors versioning anyone? heard about broken clients? did clients use your API as expected? hire more programmers to write more docs
  11. 1 PREPA RATIO N API FLOW D ESIG N &

    PRO TO TYPE D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6
  12. DOCUMENTATION ANATOMY • PROTOCOL DETAILS • AUTHENTICATION • PAGINATION •

    RATE LIMITING • HOW TO CONTACT LAWYERS • WHAT YOU THINK I WANT TO DO WITH YOUR API • DATA • WHAT CAN BE DONE WITH DATA
  13. The Unreasonable Effectiveness of Mathematics Just as there are odors

    that dogs can smell and we cannot, as well as sounds that dogs can hear and we cannot, so too there are wavelengths of light we cannot see and flavors we cannot taste. Why then, given our brains wired the way they are, does the remark, "Perhaps there are thoughts we cannot think," surprise you?
  14. REFERENCE • apiary.io/how-to-build-api • http://goodapi.co/ • https://en.wikipedia.org/wiki/The_Turk • http://amundsen.com/blog/archives/1146 •

    http://www.kurzweilai.net/memorandum-for- members-and-affiliates-of-the-intergalactic-computer- network • https://en.wikipedia.org/wiki/Richard_Hamming