Buff up your JSDocs with jsdoc-mermaid!

Buff up your JSDocs with jsdoc-mermaid!

When we built one of our new internal tools in Node, it was a no-brainer to use JSDoc syntax to document our code and the JSDoc documentation generator to turn that syntax into an easy-to-navigate HTML documentation website. But words aren’t enough to explain some of...
Insisting on Consistency: Plop

Insisting on Consistency: Plop

Fresh Starts Recently at work, I started a new application from scratch. If you’ve had this honor, then you know how energizing it can be while everything is clean and working just the way you planned; naming conventions are in place, file and directory...

Git Commit -m “Words Are Hard”

Commits are hard Commit messages can be a heated topic among engineers, although not as controversial as spaces vs tabs. At Jellyvision, we use Atlassian products for our project and code management, and gitflow for branch management. This means, we can link our code...

Don’t Be a Git—Use Tig!

I love Git. It’s an invaluable tool that has made it easier than ever to experiment with and manage code. Unfortunately, Git isn’t the easiest tool in the world to use. It depends on maintaining a complex mental model of data structures to use effectively. Luckily,...

Regression Testing with Hella Data

One of the key components of ALEX is the logic it uses to recommend insurance plans to employees. We call it The Calculator. Yes, the “T” is capitalized. Speaking the words out loud provokes thunder and dramatic music. The logic in The Calculator’s...