code clean (embedded documentation)