docs: add 'why does this exist' comments to non-obvious logic#68

marcus wants to merge 1 commit intomainmarcus/nightshift:mainfrom

why-annotatormarcus/nightshift:why-annotatorCopy head branch name to clipboard