diff --git a/doc/working_with_forms.rst b/doc/working_with_forms.rst new file mode 100644 index 0000000..42d15d4 --- /dev/null +++ b/doc/working_with_forms.rst @@ -0,0 +1,15 @@ +Working with Forms +================== + +When a browser submits a form to a server all the values included in the +form are sent to the server in an HTTP call. + +Kapow! handles the form decoding for you, the only thing you need to +know is which *field* or *fields* of the form you want. + +In this example we respond back with the content of the form field `myfield`: + +.. code-block:: bash + + kapow get /request/form/myfield | kapow set /response/body +