Engineering

Spelling Is Next to Godliness

Spelling and grammar are very important. However, when in a rush, we tend to neglect these important aspects. Search engines and humans readers usually don’t appreciate content that includes spelling or grammatical errors. This notion also applies to your code repository… As such, let’s automatically spell check and fix our codebase with misspell! Spell Check cd my-code-repository/ ~/bin/misspell -w . git commit -am "fixed spelling" -w: Overwrite file with corrections Note: Be careful with overzealous fixes!

Admonition Blocks: Making Your Documentation Stand Out

Documentation doesn’t always have to be boring. Admonition blocks draw the reader’s attention to important notes and warnings that may not directly fit as part of the flow of the text. As I often prefer to write long-form reports and documentation in LaTeX, awesomebox and alertmessage are my go-to packages for admonition blocks. Several simple examples may be found below. % !TEX program = xelatex \documentclass{article} % dummy text for examples \usepackage{lipsum} % admonition blocks around text to inform/alert readers \usepackage{awesomebox} % or without using xelatex \usepackage{alertmessage} \begin{document} % awesomebox \tipbox{\lipsum[2]} \notebox{\lipsum[3]} \warningbox{\lipsum[4]} \cautionbox{\lipsum[5]} \importantbox{\lipsum[5]} % alertmessage \alertinfo{\lipsum[2]} \alertsuccess{\lipsum[2]} \alertwarning{\lipsum[2]} \alerterror{\lipsum[2]} \end{document} Tip Box