# Iman Safari > Software engineering notes, projects, and architecture decisions. ## Posts - [Write Down the Decision Behind the Code](https://imansafari.com/write-down-the-decision-behind-the-code/): A code change makes more sense when its reasoning is still nearby. A short decision note can preserve the constraint, trade-off, and lesson that a diff alone cannot show. - [A Portfolio Should Explain the Work](https://imansafari.com/a-portfolio-should-explain-the-work/): A screenshot can show what a project looks like, but it rarely explains why it exists. A useful project page gives readers enough context to understand the decisions behind the result. ## Pages - [Contact](https://imansafari.com/contact/) - [About](https://imansafari.com/about/) - [Blog](https://imansafari.com/blog/) - [Portfolio](https://imansafari.com/portfolio/) - [Home](https://imansafari.com/): I write about the engineering decisions behind what I ship, with project notes and essays on architecture and trade-offs. [comment]: # (Generated by Hostinger Tools Plugin)