re-introduce more references to code blocks instead of putting code in the markdown