> I work on academic research project that have docs that tells you basically that the code is self documented.

Oh, that is just evil.