How do you document design decisions for a journal paper?

I keep detailed records of design iterations in my own notes, but when it comes time to write a paper, I struggle to present the decision process clearly without it reading like a diary.

Reviewers often ask why certain options were rejected, and I am never sure how much of that belongs in the article.

How do you present design decisions in a way that satisfies reviewers without overwhelming the reader?