add explanatory comments to strategic code