fix readme to explain new code architecture