Faith Okamoto

👋🏽 My CV is available. 👋🏽

• Thanks for telling me how to contribute

  (that's not sarcastic I mean it)

  By Faith Okamoto

  Posted on August 15, 2026

  I recently added a CONTRIBUTING.md file to the tool I work on. Thought I’d check out what other tools have. After about thirty seconds of trying to think of a well-used bioinformatics tool which isn’t Minimap2 (I’ve done that before) I came up with BioPython. [Read More]

  Tags:

  • published-code-critique
  • documentation
  • guidelines

• Why even have a manpage?

  at least keep this up to date!

  By Faith Okamoto

  Posted on August 1, 2026

  Among my many1 side projects is one to update our manpage. I’ll write about that. Not the update itself per se but why I care. [Read More]

  Tags:

  • manpage
  • documentation

• Magic scripts still need documentation

  and organization

  By Faith Okamoto

  Posted on July 25, 2026

  As always I forgot to grab a paper to critique until the end of the month. At least my lab’s journal club is soon so I can just grab the paper we’ll be discussing then. [Read More]

  Tags:

  • published-code-critique
  • readme

• No one cares about your guts

  give the people what they want

  By Faith Okamoto

  Posted on July 18, 2026

  I had the particular experience of listening to someone else’s code review in a meeting this week. A fellow PhD student talked to the senior dev about a proposed change.1 One point was interesting enough to write about. [Read More]

  Tags:

  • documentation
  • functional-programming

• Give me a roadmap

  or, how *not* to onboard a newbie

  By Faith Okamoto

  Posted on July 11, 2026

  You know how I go on about the importance of documentation? It’s because I want to avoid being the cause of pain like I experienced just yesterday. Let’s run back the tape. [Read More]

  Tags:

  • starting-projects
  • documentation

• Older Posts