configuration factoring and detailed commenting