[Oldletter #7] Products are made of people, a tech documentation framework and the cloud books you need on your shelf

Every Friday, I’m sharing a short list of evergreen articles/resources broadly related to software engineering that wouldn’t typically get shared in most tech newsletters or social media feeds.

  • Products are made of people (2020) by Luca Ingianni. In this short piece, my friend and DevOps consultant Luca makes a few crucial points that engineering leaders often under-appreciate:

    Software is just a small part of the product. The product also comprises things like UX, or documentation, or processes – or people! Any non-trivial system (i.e., product) will be used by people, operated by people, maintained by people. People are part of the system.

    …if you make software quality about testing, you’re doing too little too late. The fight for good quality begins way earlier, and it ends after what might be called the “QA stage” of traditional software organisations.

  • Diátaxis Framework for authoring technical documentation by Daniele Procida. A framework for understanding who your audience is to help write better technical documentation. It proposes four modes of documentation: learning-oriented tutorials, task-oriented how-to guides, understanding-oriented explanations and information-oriented references.
  • The Cloud books you need on your shelf by the Serverless Edge team. A great curation of software engineering books with a cloud/DevOps slant. The recommendations have publish dates as early as 2013, so a lot of time-tested resources in here. I’ve added a few of these to my own reading backlog.

Submitting your recommendations

If you’d like to share an evergreen article/book which has significantly influenced your thinking or practice around software delivery, please email it through to me and I’ll add it to my backlog for sharing in future editions.

Have a great weekend!

— Paul

P.S. There will be no email from me on Monday due to the Easter holidays 🐣

Join daily email list

I publish short emails like this on building software with serverless on a daily-ish basis. They’re casual, easy to digest, and sometimes thought-provoking. If daily is too much, you can also join my less frequent newsletter to get updates on new longer-form articles.

    View Emails Archive

    Architecture & Process Review

    Built a serverless app on AWS, but struggling with performance, maintainability, scalability or DevOps practices?

    I can help by reviewing your codebase, architecture and delivery processes to identify risk areas and their causes. I will then recommend solutions and help you with their implementation.

    Learn more >>

    🪲 Testing Audit

    Are bugs in production slowing you down and killing confidence in your product?

    Get a tailored plan of action for overhauling your AWS serverless app’s tests and empower your team to ship faster with confidence.

    Learn more >>