@bn2b we should document these rules