Sunny

← All weeks

What I’ve been reading (W35, 2023)

Create value · Advice from different professionals

Create value

If your job feels like a dead end, it might be because you’ve traded agency and responsibility for the feeling of security. But real security lies in creating value. Creating value isn’t easy, but it’s resilient and generous and often profitable. “How do I create more value?” is a much more useful question than, “how do I find a better job?”

Advice from different professionals

  • Doctor: Never be afraid to get a second opinion. If your doctor is offended, that’s one more reason to get one.
  • Teacher: Read to your kids from infancy, make books commonplace, and point out things in the pictures. This helps them develop literacy skills from an early age.
  • Plumber: Check your basement weekly for leaks or signs of damage, and change your air filter regularly.
  • Auto insurance adjuster: Get a dashcam to protect yourself in case of accidents or disputes.
  • Librarian: Ditch Audible and get a library card to listen to free audiobooks. Many libraries offer apps where you can download audiobooks straight to your phone.
  • Government worker: Find life satisfaction outside of the workplace.
  • Sales: Never celebrate until the money is in your account, regardless of how many times the client said yes or if there are signed documents.
  • HR: Underpromise, overdeliver, and keep your mouth shut to maintain a good reputation at work.

Advice for operating a public-facing API (cc: )

  • Host the API on its own hostname: Serve your API at api.example.com, never at example.com/api. As your API’s usage grows, it will expand beyond your website/dashboard server and need to move to a separate server or many separate servers. You’ll want to be able to move things around by just pointing its IP somewhere else rather than trying to proxy things from your dashboard server.
  • Don’t be too liberal in what you accept: Accepting a slightly non-conforming API request today might mean you’ll have to keep accepting those same non-conforming requests being made years later, often at the cost of having to implement workarounds in your web framework or server code as it gets upgraded.
  • Avoid OAuth if you can: Use static API tokens if you can, but make it easy to rotate them. If possible, avoid using an authentication mechanism that requires custom HTTP headers (including basic auth) because some esoteric devices and plugins don’t support them. Some don’t even support HTTP POST properly and will only be able to put form parameters in the URL query string.
  • Be descriptive in your error responses: Assume a human will read them, even if it’s unlikely. You might be surprised how error messages propagate but at least give the error a fighting chance to be seen.
  • Stay on top of failures:
    • You’ll want instant alerts of 5xx errors from your API when your database falls over, but think about 4xx client errors generated in response to missing required parameters, expired tokens, and other conditions that you don’t normally need to worry about.
    • Reportedly, half of all e-mail processed is spam. That means a lot of money, servers, and administrative overhead is wasted just scaling up resources to deal with junk that no one wants. If you don’t stay on top of error responses from your API, they will accumulate, and you’ll end up wasting a lot of your own money constantly serving bad requests.

Generative interfaces beyond chat Good (AI) dialogue interfaces should:

  • Have agents that co-inhabit your workspace
  • Take full advantage of rich shared context
  • Lead with constrained “happy path” actions
  • Fall back to chat as an escape hatch
  • Speed up iteration for fast feedback loops

Why listening on its own is not compassion.

  • Compassion can be defined in any number of ways, but the entry point is the ability to listen.
  • We often characterise listening as the period of silence where you’re not talking, but the reality is that your mind rarely listens during these moments. You’re often thinking about what you’re going to say next or are thinking about something completely unrelated to the topic at hand.
  • Compassion is what you then do with everything you’ve heard. Compassion is often depicted as this love-is-everywhere, all-is-well kind of thing, but in reality, it’s a kinetic force. It’s something that’s expressed, and any avenue of expression must utilize some form of energy. To be compassionate is to take active participation in another’s life, and to commit to that wholeheartedly.
  • Listening is to hear someone’s plight, but compassion is to then offer to alleviate that plight. It’s to be involved in someone’s struggle; not because you’re obligated to or because you feel that you’re a more virtuous person in doing so.
  • The reason why compassion is the greatest virtue is because it’s the most difficult thing to cultivate. Compassion stems from the awareness that we are all integrated in a way that we will never fully comprehend. Ultimately, compassion is the greatest virtue because it’s the one that takes the most effort and intention.

Others

Substack edition

View the original post

Create value

If your job feels like a dead end, it might be because you’ve traded agency and responsibility for the feeling of security.

But real security lies in creating value.

Creating value isn’t easy, but it’s resilient and generous and often profitable.

“How do I create more value?” is a much more useful question than, “how do I find a better job?”

Advice from different professionals

  • Doctor: Never be afraid to get a second opinion. If your doctor is offended, that's one more reason to get one.

  • Teacher: Read to your kids from infancy, make books commonplace, and point out things in the pictures. This helps them develop literacy skills from an early age.

  • Plumber: Check your basement weekly for leaks or signs of damage, and change your air filter regularly.

  • Auto insurance adjuster: Get a dashcam to protect yourself in case of accidents or disputes.

  • Librarian: Ditch Audible and get a library card to listen to free audiobooks. Many libraries offer apps where you can download audiobooks straight to your phone.

  • Government worker: Find life satisfaction outside of the workplace.

  • Sales: Never celebrate until the money is in your account, regardless of how many times the client said yes or if there are signed documents.

  • HR: Underpromise, overdeliver, and keep your mouth shut to maintain a good reputation at work.

Advice for operating a public-facing API

  • Host the API on its own hostname: Serve your API at api.example.com, never at example.com/api. As your API's usage grows, it will expand beyond your website/dashboard server and need to move to a separate server or many separate servers. You'll want to be able to move things around by just pointing its IP somewhere else rather than trying to proxy things from your dashboard server.

  • Don't be too liberal in what you accept: Accepting a slightly non-conforming API request today might mean you'll have to keep accepting those same non-conforming requests being made years later, often at the cost of having to implement workarounds in your web framework or server code as it gets upgraded.

  • Avoid OAuth if you can: Use static API tokens if you can, but make it easy to rotate them. If possible, avoid using an authentication mechanism that requires custom HTTP headers (including basic auth) because some esoteric devices and plugins don't support them. Some don't even support HTTP POST properly and will only be able to put form parameters in the URL query string.

  • Be descriptive in your error responses: Assume a human will read them, even if it's unlikely. You might be surprised how error messages propagate but at least give the error a fighting chance to be seen.

  • Stay on top of failures:

    • You'll want instant alerts of 5xx errors from your API when your database falls over, but think about 4xx client errors generated in response to missing required parameters, expired tokens, and other conditions that you don't normally need to worry about.

    • Reportedly, half of all e-mail processed is spam. That means a lot of money, servers, and administrative overhead is wasted just scaling up resources to deal with junk that no one wants. If you don't stay on top of error responses from your API, they will accumulate, and you'll end up wasting a lot of your own money constantly serving bad requests.

Generative interfaces beyond chat

Good (AI) dialogue interfaces should:

  • Have agents that co-inhabit your workspace

  • Take full advantage of rich shared context

  • Lead with constrained “happy path” actions

  • Fall back to chat as an escape hatch

  • Speed up iteration for fast feedback loops

Why listening on its own is not compassion.

  • Compassion can be defined in any number of ways, but the entry point is the ability to listen.

  • We often characterise listening as the period of silence where you’re not talking, but the reality is that your mind rarely listens during these moments. You’re often thinking about what you’re going to say next or are thinking about something completely unrelated to the topic at hand.

  • Compassion is what you then do with everything you’ve heard. Compassion is often depicted as this love-is-everywhere, all-is-well kind of thing, but in reality, it’s a kinetic force. It’s something that’s expressed, and any avenue of expression must utilize some form of energy. To be compassionate is to take active participation in another’s life, and to commit to that wholeheartedly.

  • Listening is to hear someone’s plight, but compassion is to then offer to alleviate that plight. It’s to be involved in someone’s struggle; not because you’re obligated to or because you feel that you’re a more virtuous person in doing so.

  • The reason why compassion is the greatest virtue is because it’s the most difficult thing to cultivate. Compassion stems from the awareness that we are all integrated in a way that we will never fully comprehend. Ultimately, compassion is the greatest virtue because it’s the one that takes the most effort and intention.

Others

Originally on Substack