readme: document magic comments