The Real Guide to Engineering Documentation: What Actually Works

After 18 years in tech, I’ve seen documentation fail in almost every way possible. From outdated wikis that no one reads to massive Google Doc graveyards that make your eyes glaze over. But I’ve also discovered what actually works. Here’s the real deal on documentation that people will actually use. The Hard Truth About Documentation… Read More The Real Guide to Engineering Documentation: What Actually Works

5 Ways to Avoid Getting Laid Off: Reverse Engineer the McKinsey 9 box talent matrix

Discover the layoff process in large companies, where managers rank employees and HR uses “unbiased”, data-driven formulas to decide who stays. Key factors influencing layoffs include location, performance, productivity, salary, progression, cost center vs. profit center status, and future investment in teams. Employees with higher scores face higher layoff risks. Learn strategies to boost your job security by enhancing performance, showing potential, and aligning with business priorities.… Read More 5 Ways to Avoid Getting Laid Off: Reverse Engineer the McKinsey 9 box talent matrix

Three Timeless Lessons from Renaissance Italy for Modern Software Engineering

This article draws parallels between historical and modern practices to highlight the importance of control, mentorship, and competition in fostering innovation. The push to return to the office mirrors the centralization efforts seen in the construction of the Uffizi by the Medici, designed to consolidate power and nurture creativity. Similarly, the division of labor in Renaissance art, exemplified by The Baptism of Christ, reflects the modern practice of senior software engineers guiding junior developers. Finally, just as competition among Renaissance artists spurred innovation, bringing developers together in the office can drive creativity and excellence in software engineering.… Read More Three Timeless Lessons from Renaissance Italy for Modern Software Engineering

C-Requests: amigdala hijacking in software

This article discusses the challenges that arise in software engineering teams when urgent requests from executives disrupt the workflow. It highlights the impact of scarcity mindset on attention and decision-making. The author shares a scenario where an urgent request from a Vice President derails ongoing work, leading to rushed implementation, lack of quality control, and future issues. The cultural differences and hierarchical leadership styles in lower-cost outsourcing destinations are also mentioned as factors that affect decision-making. Strategies for mitigating these challenges are presented, including the role of product managers in shielding the team, maintaining a well-prioritized backlog, and physically separating external requests from the team’s work.… Read More C-Requests: amigdala hijacking in software