documenting code & minimal changes