fix code block; more implementation notes