Monday Links 13

Learning from the incident you didn’t have

When an incident happens in an organization, the traditional response is to identify ways to prevent the incident from happening again in the future. The community around this website takes a different approach towards incident analysis. To paraphrase the late computer scientist Edsger Dijkstra, incident analysis is no more about incidents than astronomy is about telescopes. Instead of focusing on prevention, we seek to leverage incidents as an opportunity to learn as much as possible about how work is done within the organization.

Import AI Newsletter on the discussion about the safety of releasing AI models without restriction

Rep. Anna Eshoo (a Democrat from California) has sent a letter to the White House National Security Advisor and Office of Science and Technology Policy saying she has “grave concerns about the recent unsafe release of the Stable Diffusion model by Stability AI”. The letter notes that Stable Diffusion can be used to generate egregiously violent and sexual imagery, and - due to eschewing the kinds of controls that OpenAI uses for its commercial product DALL-E2 - the freely accessible model represents a big problem.

Letters like this are indicative of a culture war brewing up among AI researchers; on one side, groups want to slowly and iteratively deploy new technologies via APIs with a bunch of controls applied to them, while on the other side there are people who’d rather take a more libertarian approach to AI development; make models and release the weights and ride the proverbial lightning.

Andrew Huberman on the optimal morning routine

Programmers are at their best when they can focus deeply on a task. Managers thrive when they have the energy to context switch. A good sleep and an efficient morning routine help a lot in both cases.

Andrew Huberman is a professor in the Department of Neurobiology at the Stanford University School of Medicine. In this chat with Jocko Willink, Huberman discusses what happens in your body when you sleep and wake, and talks about practices that can help set you up for a day of good work.

Among Huberman’s tips:

  • Aim to have a good sleep 80% of the time
  • Get natural light in your eyes within an hour of waking up
  • Excercise early
  • Try cold water to raise your body temperature
  • Delay your intake of caffeine by 90 minutes

Monday Links 12

Simon Willison’s recommended engineering practices are rock solid:

  • Documentation in the same repo as the code
  • Mechanisms for creating test data
  • Rock solid database migrations
  • Templates for new projects and components
  • Automated code formatting
  • Tested, automated process for new development environments
  • Automated preview environments

Also from Simon Willison: Documentation Unit Tests (or Test-Driven Documentation)

Keeping documentation synchronized with an evolving codebase is difficult. Without extreme discipline, it’s easy for documentation to get out-of-date as new features are added.
One thing that can help is keeping the documentation for a project in the same repository as the code itself. This allows you to construct the ideal commit: one that includes the code change, the updated unit tests AND the accompanying documentation all in the same unit of work.
When combined with a code review system (like Phabricator or GitHub pull requests) this pattern lets you enforce documentation updates as part of the review process: if a change doesn’t update the relevant documentation, point that out in your review!

In Aging Programmer, Jorge Manrubia reflects on 15 years of programming and what he has found to be true for himself.

Monday Links 11

Two years ago GitHub archived all the open source repos they host along with copies of StackOverflow and Wikipedia on 188 reels of archival film inside a decommissioned coal mine in the arctic. Last week they talked about the why and how.

Gina Trapani talks about why senior leaders sometimes seem less engaged than you’d expect and presents some tips on how to get your message across to them

Charity Majors’s latest post, The Hierarchy Is Bullshit (And Bad For Business), is chock-full of good stuff like this:

Power flows to managers by default, just like water flows downhill. Managers have to actively push back on this tendency by explicitly allocating powers and responsibilities to tech leads and engineers. Don’t hoard information, share context generously, and make sure you know when they would want to tap in to a discussion. Your job is not to “shield” them from the rest of the org; your job is to help them determine where they can add outsize value, and include them. Only if they trust you to loop them in will they feel free to go heads down and focus.