Documentation As Code
One of the most common failure points in software projects isn't the code — it's the documentation next to it. It goes stale the week after it& … »
New Data Team Member Onboarding Guide
first-week onboarding course for new data team members, from understanding the stack and getting access to running a first Snowflake query, exploring dashboards, and completing a setup checklist. … »
Fixing xcrun Error on MacOS
Sometimes following an OS update, you may be faced with the following error: xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/ … »
zsh compinit: insecure directories and files
The default shell for MacOsx, starting with Catalina OS, is no longer .bash but is now .zsh. While you can easily change back to bash if you prefer, zsh does … »
Technical Writing
Good technical writing should be easy to read. The reader should be able to switch in and out of the written instructions without getting lost. It should be engaging — the reader should want to see the instructions through to the end. Even better is if the reader learns something new and valuable ab … »