File Organization: Type vs. Context

This article explores two common approaches to organizing code files: by type and by context. Using a real-world Identity and Access Management (IAM) system as an example, the author compares the pros and cons of each method. While organizing by type is convenient for finding specific file types, it falls short in understanding the business logic and maintainability of the code. Organizing by context, however, more clearly reveals the system's business processes, facilitating team collaboration and troubleshooting, and is better suited for large projects. Ultimately, the author concludes that the best choice depends on team size, project characteristics, and workflow, with no absolute superior method.