Document allowing keyword args before positional

I can't believe I never wrote this down. Maybe it's in the manual elsewhere and now I've misplaced it. Oh well.

Author: Kodiologist

docs/syntax.rst

@@ -190,6 +190,12 @@ at compile-time. To prevent a literal keyword from being treated specially in
 an expression, you can :hy:func:`quote` the keyword, or you can use it as the
 value for another keyword argument, as in ``(f :foo :bar)``.
 
+Whereas Python requires all positional arguments in a call to precede all
+keyword arguments, Hy allows them to mingled, as in ``(f 1 :foo 2 3)``. This is
+implemented by simply moving the keyword arguments back, as in ``(f 1 3 :foo
+2)``, with the attendant consequences for order of evaluation (:ref:`which
+shouldn't generally be relied upon in Hy <order-of-eval>`).
+
 Otherwise, keywords are simple model objects that evaluate to themselves. Users
 of other Lisps should note that it's often a better idea to use a string than a
 keyword, because the rest of Python uses strings for cases in which other Lisps

docs/tutorial.rst

@@ -229,6 +229,11 @@ Set a function parameter by name with a ``:keyword``::
 
     (test 1 2 :d "y")             ; => [1, 2, None, 'y', ()]
 
+Keyword arguments may be placed before or among positional arguments, with the
+same effect as putting all the positional arguments first::
+
+    (test 1 :d "y" 2)             ; => [1, 2, None, 'y', ()]
+
 Note that unlike Python, Hy doesn't always evaluate function arguments (or the
 items in a literal list, or the items in a literal dictionary, etc.) :ref:`in
 the order they appear in the code <order-of-eval>`. But you can always force a