added a design note
fixed a test