Hi, I'm Eric.

I’m an avid world traveler, photographer, software developer, and digital storyteller.

I help implement the Content Authenticity Initiative at Adobe.

I use complete sentences

6 September 2025

  • Last updated on 11 September 2025

Most of the time, I write comments and documentation using complete sentences.

It’s not always necessary, but it usually makes things clearer and more professional-looking.

Comments

I almost always write comments as complete sentences, with proper punctuation.

Example 1. Comments in complete sentences
// Recursively apply passthrough replacement and write the result.
let replacer = PassthroughRestoreReplacer(self.0, self.1);
Example 2. Comments not formatted as a sentence
// recursively apply passthrough replacement and write the result
let replacer = PassthroughRestoreReplacer(self.0, self.1);

Exception: Titles and captions

As you can see throughout this site, I don’t force titles and captions to be complete sentences when it would sound awkward. Sometimes it works (like the title of this page), but other times it’s more natural to use a phrase (like this section’s title).

Either way, I format titles and captions using sentence case.

Since they might or might not be complete sentences, I skip the trailing period on titles and captions.

If you’ve enjoyed this …

Subscribe to my free and occasional (never more than weekly) e-mail newsletter with my latest travel and other stories:

Or follow me on one or more of the socials: