Faith Okamoto

👋🏽 My CV is available. 👋🏽

• Help others help you

  January 2025

  By Faith Okamoto

  Posted on January 31, 2025

  Technically this paper isn’t published yet, but it’s on biorXiv and has gone through revision with a journal, so I’m using it. Also I’ve just spent the better part of a week trying to use its software. [Read More]

  Tags:

  • published-code-critique
  • documentation
  • naming

• Reproduce your work

  (Ideally somewhere else)

  By Faith Okamoto

  Posted on January 25, 2025

  Here’s another post about something that’s relevant to my last week. (I will get around to another code critique before the month ends, I promise, to my nonexistent readers.) [Read More]

  Tags:

  • process
  • last-pass

• Useful error messages

  How did I mess up?

  By Faith Okamoto

  Posted on January 10, 2025

  Since I made two recent pull requests about graceful errors, I figured I’d talk about why this is so important. In general, you should try to anticipate common issues the end-user might run into. Those errors should cause useful, descriptive error/warning messages. [Read More]

  Tags:

  • errors

• In praise of writing documentation

  Yes, I actually enjoy this

  By Faith Okamoto

  Posted on January 4, 2025

  I’m ill and having difficulty concentrating. Somehow writing documentation came to mind. There’s no way I could write new code in my current state, but I’d be just fine with documentation. [Read More]

  Tags:

  • documentation
  • docstrings

• Do a final cleanup

  December 2024

  By Faith Okamoto

  Posted on December 23, 2024

  I’ve blathered on for ten posts about my code habits. Now I’ll look at other scientists’ code. This blog post is the first of a series. Once a month, I’ll critique the code released by a recent paper. Hopefully concrete examples will make clear principles I’ve discussed. [Read More]

  Tags:

  • published-code-critique
  • last-pass

• Newer Posts
• Older Posts