Looks bad to me. I would prefer a prose design overview and code separate. Comments like this always go out of date because people don't reread every comment w

Looks bad to me. I would prefer a prose design overview and code separate. Comments like this always go out of date because people don't reread every comment when they make a change.