A Philosophy of Software Design

by John Ousterhout

It’s better to write the interface comment for each method before its body, so you can focus on the method’s abstraction and interface without being distracted by its implementation.