Notes about the inputValue attribute in paper-input

Examples of how and when to use inputValue in favor of value.
I now see that, I thought this feature wasn't documented.  I don't see a convention in other paper elements mentioning the features of the core elements they inherit from.  Should we start a convention for doing that?

Perhaps a link saying, inheriting attributes from core-_____?