docs and ensure emit