Revert "Revert "more explanations""

This reverts commit 6cc85a1ecee9c2efe666477e2796471b315b2b99.