Source: Better Explained
Published: January 2022
Learn Difficult Concepts with the ADEPT Method
Make explanations ADEPT: Use an Analogy, Diagram, Example, Plain-English description, and then a Technical description.
ADEPT: Analogy
Key Idea: What else is it like?
Example: At a restaurant, the menu is the API. The waiter takes your order (the API request). Then the waiter delivers the food when it is ready from the kitchen (the API response).
ADEPT: Diagram
Key Idea: Visualize it.
Example:
ADEPT: Example
Key Idea: Experience it.
Example:
Request: Customers -> Waiter -> Kitchen
Response: Customers <- Waiter <- Kitchen
ADEPT: Plain English
Key Idea: Describe it with everyday words.
Example: An API is a digital intermediary that handles requests and responses.
ADEPT: Technical Definition
Key Idea: Dive deep.
Example: An API allows other developers to use your services without allowing them access to your backend, for example, your database.
Are you hiring tech talent? Email me to feature your job in this newsletter.
This is great! What do you use to create your images? I love the notepad style pictures