Chris Basham

Organizing design work

We can improve the way we and our coworkers work by being thoughtful in the ways we organize folders, files, and other project materials. Specifically, we can use dates, times, references, and descriptions to help scale work output, be more productive, and think about the work that has been done.

1. Project log

A project log documents notable things about a project, organized chronologically. Each entry should include the date, what happened, and who was involved. Entries could describe when a project was kicked off, when major meetings happened, when a new user research initiative started, and when development on a particular feature started or finished. Entries could link to reports, mockups, references, plans, issues, etc.

Capturing these details makes it easier to remember the journey of your team and reflect on the challenges along the way. It can be a reference for reports and discussions with stakeholders. For example (links are represented with underlined text):

2. Design decision document

A design decision document captures why a design decision was made. This could be useful when a team member or stakeholder questions a decision of something designed weeks earlier or when there is a production support question from a user encountering a problem. Entries should include the date, a description of the decision and why it was made, and who was involved in making the decision. For example:

3. User research sessions

User research sessions can produce many files: the session recording and transcript, session notes, emails, etc. To keep it organized, those files should be grouped in a common folder. The folder should be named in a consistent manner, so that it is straightforward when conducting multiple research sessions and easy to reference. As such, the folder name should include:

To sort folders chronologically, the first part of the name should be the year, month, and day of the research session, such as 2023-10-20.

Since multiple research sessions can occur in the same day, it is more precise to also include the time of the session. The 24-hour “military” time format guarantees correct sort order. 1330 means 1:30 PM.

The researcher is more likely to remember details about the participant than the time the session occurred. So, the third part of the folder name should include the participant’s name.

Together, the folders could be named like:

In this format, it is easy to notice there was over a two-month gap between sessions (skipping June and July). You can also infer there was a follow-up session with Yuri, because there was only a three-day gap between the two concurrent sessions they were participating in.

4. User research projects

User research projects should also be organized with folders, because they can also involve multiple files, such as the research plan, research report, recruitment templates, etc. Similar to the user research session folder names, project folder names should include the date the project started and a description of the project. If a project is related to a specific issue in the team’s ticket tracking system (such as Jira), then that reference (e.g. #2740) should be included in the description. For example:

It may be best to keep the session folders separate from the project folders. Let’s say the culmination of a user research project is a user research report. The report may reference sessions conducted before the project officially started. If session folders are nested under their respective project folders, then that may result in:

Instead, perhaps there is a “User Research Session” folder that contains all the session folders and a “User Research Projects” folder that contains all the project folders. This separation:

Folder aliases or shortcuts could also be placed in the project folders to reference related sessions. This would be a good compromise, which maintains both the centralization of related materials and the separation of different materials.

5. Figma pages

Dates, references, and descriptions are also useful to organize Figma pages. For example, this design exploration resulted in five prototypes used during two months of user research sessions. It culminated in another page (“Dev Phase 1”) that is meant to guide the development team during the initial implementation of the software.

6. Figma flows

Each page in Figma may contain any number of interactive “flows.” Figma flows are the starting points for users to navigate among different frames (“screens”), which simulates the experience with a user interface.

The development team may organize their work according to user stories in a ticket tracking system. To align with the team, the designer can create a unique flow for each user story that a development team needs to understand, implement, and verify the work. The links to these flows can be included in the user story. Flows can be labeled with the unique reference number and short description of its corresponding user story. For example:

Conclusion

The design of our work process can facilitate the design of better solutions for users of our work. We can be kind to our colleagues and our future selves by being more deliberate and disciplined in what we capture about a project and how we document it. Oftentimes, all that is needed to improve the usability of our work is to add dates, times, references, and descriptions to the things we make.