update form documentation for new usage

After the awesome work done in #1176 & #1169, the documentation needed an update. 
Let me know if I missed anything or if anything is unclear
/cc @seanstrom @dotcypress @simov