aprao

It seems to me that the mechanism to maintain a ledger of user accounts is mostly the same across companies and domains, even though it is probably implemented from scratch in each company. Even if the account asset type is different, the concept of transfers (credit one account, debit another), account creation/update, history, statement generation, and correctness of calculations is mostly the same for an e-commerce store or an exchange.

Has this been true in your experience?

Coda and Confluence are very heavy weight and slow. Also, it's a pain to create pages when you need to tab back and forth to copy text and pictures. Any other solutions in the market that do a better job?

At work, I find myself writing a Python/Go/JS SDK for every single internal API that I implement. This might even be more prevalent for public facing APIs since creating/maintaining public API SDKs for popular languages are table stakes for usage.

- Has this generally been true in your experience as well?

- If so, are there any hacks to create these SDKs with support for best practices like pagination, retry, etc + update them them when the API changes?

Imagine a very simple user creation flow in an online marketplace:

- Service A (user service) receives the request and creates a user object and sends an async request to service B and C (e.g. via Kafka)

- Service B (notification service) receives the request and sends an email to the newly created user

- Service C (referral service) receives the request and credits some funds to the referrer

While this design might be laid out correctly in a design doc, it is only implicitly defined in code because the services talk to each other. How would you:

- Ensure that the services are talking to each other in the correct order when implementing the user creation flow (integration tests might not suffice here since they generally test a very narrow set of path)?

- Define and enforce SLO guarantees between services in production?

- Debug which service is to blame when the flow breaks down?