Accompany this behavior with both javadocs and updates to the documentation please.