update requirements; add notes