add explanatory note about block implementations