notes
What to ask a hiring manager
My favorite question to ask hiring managers, “Can you tell me about someone you have promoted in recent years?”.
https://x.com/1sprintatatime/status/1820909764752372191?t=ke7vyfHAFSvCrZ48sO_Brg&s=19
read more
notes
Filter Query Language
The value of the filter query parameter is an expression involving the fields of the resource that produces a Boolean value. This expression is evaluated for each resource in the collection, and only items where the expression evaluates to true are included in the response.
https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#filter
read more
notes
API Documentation and Lifecycle
API documentation can be so much more than API documentation. [It] can be the thread connecting all the stages of the API consumer lifecycle.
https://notes.brunopedro.com/2024/06/27/20240627230846/
read more
notes
Advanced Encryption Standard
The Advanced Encryption Standard (AES) is a specification for how electronic data should be encrypted that was published by the National Insitute for Standards in Technology (NIST) in the U.S. in 2001
https://www.thoughtworks.com/insights/blog/privacy/illustrated-guide-advanced-encryption-standard?utm_medium=email&utm_source=marketo&mkt_tok=MTk5LVFERS0yOTEAAAGTfWHXbMeay5dEA78XJDcrELbG96ewhrXEctQc2eHKwAZXhDiPTQAc3VfKce7JKG_WxHuTk8JSwgDCi3K26nb3Zo9UfC7qi7F7eGy_k_KMJVVombQ
read more
notes
Respectful Disagreements
When you disagree with someone in words while being truly agreeable in demeanor, many people will match your conduct. They will discuss with you rather than attack you.
read more
notes
API Design Guidelines Impact
A list of key finding to illustrate the impact of AIP Guidelines in the areas of API consumption and API production:
API Production:
Increased Requirement Fulfillment: A controlled developer experiment showed that developers using API Improvement Proposals (AIPs) and an API linter achieved a 10% higher requirement fulfillment rate compared to those without any protocols. Feedback Utility: Among developers using the linter tool alongside AIPs, 75% found it beneficial, aiding significantly in refining their API designs.
read more
notes
API Usability Challenges
Challenges in API usability, as highlighted by Scaffidi [18] and [16], include inadequate documentation, insufficient orthogonality, and mismatches between API abstractions and application requirements.
https://dl.acm.org/doi/10.1145/3613905.3650803
read more
notes
API Designer role
The role of API Designer can evolve from Product Design or Architecture. API Designers should understand Product, UX, DX, technical and architectural constraints.
https://brunopedro.com
read more
notes
The Strategy Tax
The problem that big, established companies get into is what is referred to as the strategy tax.
This is basically the fact that they have to sort of fit their next big thing into their existing agenda.
And they often compromise in the process.
read more
notes
Benchmarking
During benchmarking, pay attention to the outliers. Measure P99 of everything. The average is not meaningful.
read more