rewrite api doc for FormWidget and FormValueWidget, fixes #18363

cc @AdrianVasiliu 

Hopefully this addresses all the points you brought up.  You can add some inline comments if you see places for further clarification.
Right, property. Which means that, after user interaction, the value property of the input can become different than the value attribute initially specified for the input in markup (if any)?