preempt: document architecture