/Management

The Ultimate Guide To Software Architecture Documentation

- Patrick Roos tl;dr: "This guide shows you how to write, structure, visualize and manage software architecture documentation in a lean way using appropriate documentation tools."

featured in #384


Refactor Your Code - Don’t Be Like Southwest Airlines

- Shanea Leven tl;dr: Devs don’t have a way to communicate the complexity hidden in their code to business leaders — they lack code visibility tools. As a result, refactors aren’t prioritized until you have a Southwest-sized crisis. Here’s 9 tips to avoid being southwest.

featured in #384


We Invested 10% To Pay Back Tech Debt; Here's What Happened

- Alex Ewerlöf tl;dr: Alex discusses how "Tech Debt Friday" started at his org, what was learned and how it's executed: (1) We spend 10% of our time to deal with tech debt. (2) The first rule is not to create debt in the first place. (3) The PR that creates tech debt should come paired with the issue to deal with it. And more. 

featured in #383


What Is Code Visibility?

- Shanea Leven tl;dr: Onboarding to a new codebase often involves hours of frustration. But, it doesn’t have to. Shanea explains how code visibility tooling keeps codebases from becoming untouchable black boxes. With a shared visual model that can be maintained through code iterations, developers can be more productive and ship code with fewer bugs.

featured in #383


Resilience And Waste In Software Teams

- Jessica Kerr tl;dr: Jessica explains resiliency in the context of the Southwest Airlines software failure. "When software is brittle, it falls over in production, and that falls to people to fix. While software can be robust to anticipated conditions, only people handle unexpected events. When software can’t even handle stuff that happens all the time, then people suffer the strain."

featured in #383


Meetings For An Effective Eng Organization

- Will Larson tl;dr: "I’d like to recommend 6 core meetings that I recommend every organization start with, and that I’ve found can go a surprisingly long way. These six are split across three operational meetings, two developmental meetings and finally a monthly engineering Q&A to learn what the organization is really thinking about." Will discusses each in depth. 

featured in #382


What Big Tech Layoffs Suggest For The Industry

- Gergely Orosz tl;dr: Gergely discusses rapid shifts in the engineering job market. "It’s certain we’ll see a correction of 2021-22’s hiring frenzy and it’s a given that Big Tech will hire much less this year than in 2022, while the question remains whether other large tech companies will follow suit and announce layoffs in the coming months."

featured in #382


Why Your Team Should Be Using Just-in-Time Access

- Adam Buggia tl;dr: Least privilege in the cloud is hard, but progress can be made by taking a risk-based approach. Consider an attacker who obtained one of your developer’s credentials; what access would they have? By adding a temporal dimension to developer access policies, the attack surface can be significantly reduced for many security-breach scenarios. That’s where just-in-time access comes in.

featured in #382


Evaluating Managers: 5 Heuristics To Measure Managerial Impact

- AbdulFattah Popoola tl;dr: Measuring a manager’s impact is hard since outcomes take time. This post provides early evaluation metrics as well as tips for course correction. Each of the following heuristics are explained in detail: execution, people management, team development, strategic vision & organizational influence.

featured in #381


Visual Workflow Automation. Now With Code.

tl;dr: Build powerful automations fast, with all the hackability you’d expect as a developer. Stop provisioning infrastructure and maintaining one-off scripts. Write and automate cron jobs, custom alerts, and ETL tasks 10x faster with Retool Workflows.

featured in #381