What harm is there in adding documentation ? it's a kind of executive abstract for those not reading below the first lines, which is a good habbit IMHO