companion to my medium.com articles