Documenting shellscripts

This blog post outlines how shellscripts contain way too much business logic and why it is a shame to keep them undocumented.