"Interface files" that are intended as a form of documentation should be generated automatically instead. As for interface vs. implementation docs, nothing pre

"Interface files" that are intended as a form of documentation should be generated automatically instead. As for interface vs. implementation docs, nothing precludes having both in a single file either.