adding requirements, example usage, and moving layout arrangement to better area