Считаю, что документация должна быть такой же качественной, как и код.