02 Aug 2025

Daily review

History / Edit / PDF / EPUB / BIB / 1 min read (~62 words)
processes

Every daily at the end of the (work) day.

15 minutes.

  • Review what was planned for the day
  • Provide feedback related to the plan
  • Track and review
    • How many times I was interrupted
    • How much time I spent on unexpected work
    • Whether I got blocked and for how long
  • Review weekly plan and align
  • Plan next day
02 Aug 2025

Weekly review

History / Edit / PDF / EPUB / BIB / 1 min read (~51 words)
processes

Every week, either at the beginning or end of the week.

15 minutes.

  • Review what was planned for the week
  • Provide feedback related to the plan
    • Write down what was worked on that wasn't part of the plan
  • Review monthly plan and align
  • Plan next week
17 Sep 2024

Solving hard software problems

History / Edit / PDF / EPUB / BIB / 1 min read (~81 words)
processes
  • For problems related to environment setup, trying to accomplish the same thing on two computers can help identify disparities caused by the environment and not the code itself.
  • If you are blocked when trying to solve your problem, define timebox how long you will continue attempting to address the problem before changing your approach.
    • Every half-hour/hour ask yourself "Have I made progress in the last period?" If the answer is no, define a time limit before reassessing your next steps
14 Apr 2022

Incident investigation

History / Edit / PDF / EPUB / BIB / 2 min read (~217 words)
processes
  • Define the incident owner
  • Define the incident secretary/communicator
  • Create and document
    • Summary
    • Observations (link to metrics dashboards with absolute timestamps as much as possible)
      • Screenshots
        • Who took the screenshot
        • Link to get the graph/data
        • Associated conclusions
      • Links to logs
    • Hypotheses/theories
      • Who made them
      • When
      • If they have been validated/invalidated
    • The actions taken
      • By whom
      • If it had the desired effect
    • etc.
  • In the situation where an incident has been caused by the introduction of a code regression, revert the change and deploy as soon as possible
  • Start by reducing/relieving the impact of the incident before searching for a root cause
  • Use multiple data sources when data sources do not agree
  • Diagram all the implicated systems and the relationship to one another in order to identify the potential locations where the problem might be
  • Test your hypotheses to verify if they hold or not
  • Develop a procedure over time that can be followed to diagnose similar issues
  • Write down a list of improvement suggestions in order for the incident not to reproduce itself in the future or to lessen its impact

  • Once the incident is completed, have a summary of the conclusions at the top of the document with a link to the sections in the document explaining the rationale behind the conclusions
14 Apr 2022

Incident post-mortem

History / Edit / PDF / EPUB / BIB / 1 min read (~43 words)
processes
  • Identify the cause of the problem
    • 5 whys
  • List potential solutions
  • Investigate potential sources of similar problems
  • Address the additional sources of risk

  • Reduce incident duration
    • Identify the cause of the problem more rapidly
  • Reduce incident cost
  • Reduce the number of people involved