add @todo to docs; smaller dev_only comment