I surely agree with your point of view. Every feature should be built to be self-explanatory, that would be a great user experience. Both the developer and the user will save a lot of time not needing to write (dev) or go through (user) a huge documentation.