updated docs based on design