Updating documentation with design considerations