Faith Okamoto

👋🏽 My CV is available. 👋🏽

• Revamping documentation

  or, a to-do list

  By Faith Okamoto

  Posted on October 25, 2025

  My lab is hoping to rework a toolkit’s documentation to follow Diátaxis principles. Or, more honestly, to follow any principles other than just being whatever was easiest to write. [Read More]

  Tags:

  • documentation
  • refactoring

• Examining demo code samples

  October 2025

  By Faith Okamoto

  Posted on October 12, 2025

  One of my roommates is a statistics PhD so I thought I might try looking at a statistics paper. Or, honestly, just the code from a statistics paper. Actually understanding the entire paper would require way more time than I am willing to devote to a single blog post. [Read More]

  Tags:

  • published-code-critique
  • examples

• Config files vs. hardcoding

  An alternative for bespoke file names

  By Faith Okamoto

  Posted on October 4, 2025

  I’m heading to a conference (the Human Pangenome Reference Consortium’s 2025 meeting) and, through accident or luck, I have my fingers in three things: I’m speaking for part of one talk, giving a few plots to another, and presenting my own poster. This meant that I needed to get a... [Read More]

  Tags:

  • hardcoding
  • parameters
  • plots

• Things I care about too much

  a listicle

  By Faith Okamoto

  Posted on September 27, 2025

  Classes have started again1 and I’m remembering why I wasn’t doing these posts weekly2. So, instead of thinking of anything substantial to write about, I figured I could just do a listicle. The Internet likes listicles, right? [Read More]

  Tags:

  • style

• Documentation and mega-tools

  September 2025

  By Faith Okamoto

  Posted on September 22, 2025

  As is probably obvious from my blogging history, I work on the vg toolkit. And if there’s one thing vg is known for (besides our papers with cool results and all that), it’s that, while the toolkit is quite powerful, it is a pain to get into. Sheer complexity has... [Read More]

  Tags:

  • documentation
  • readme
  • getting-started
  • published-code-critique

• Newer Posts
• Older Posts