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.
(Minor) Maybe better:  "requires that `this.focusNode` to be a sub-node" or  "requires that `this.focusNode` is a sub-node"