A common issue when documenting requirements is taking a stand from the system perspective to describe what is needed, forgetting that it’s the user who will be at the center of the interactions. User stories, introduced by Agile, tackle this issue by making the user the center of the requirement, and Behavior Driven Development (BDD) takes things a step further providing a framework where the user behavior is what drives the development.
In the world of CSS, documentation is underused. Since documentation is not visible to the end user, its value is often overlooked by clients. Also, if it’s your first time documenting code, it can be difficult to determine what to document and how to do it most effectively.