Add docs for experimental delete (#303)

* Add docs for experimental delete

the implementation seem shared,
it took me a couple of minutes to figure this out,
it seems wise to add a seperate header showing how,
it ought to work for the new API.

Add changes to change log

bump version number

fixup pr link

* Update esqueleto.cabal

Co-authored-by: Matt Parsons <parsonsmatt@gmail.com>

* Update changelog.md

Co-authored-by: Matt Parsons <parsonsmatt@gmail.com>

Co-authored-by: Matt Parsons <parsonsmatt@gmail.com>

changelog.md

@@ -1,3 +1,10 @@
+
+3.5.3.1
+=======
+- @jappeace
+  - [#303](https://github.com/bitemyapp/esqueleto/pull/303)
+      - Added docs for delete function for new experimental API.
+
 3.5.3.0
 =======
 - @m4dc4p

esqueleto.cabal

@@ -1,7 +1,7 @@
 cabal-version: 1.12
 
 name:           esqueleto
-version:        3.5.3.0
+version:        3.5.3.1
 synopsis:       Type-safe EDSL for SQL queries on persistent backends.
 description:    @esqueleto@ is a bare bones, type-safe EDSL for SQL queries that works with unmodified @persistent@ SQL backends.  Its language closely resembles SQL, so you don't have to learn new concepts, just new syntax, and it's fairly easy to predict the generated SQL and optimize it for your backend. Most kinds of errors committed when writing SQL are caught as compile-time errors---although it is possible to write type-checked @esqueleto@ queries that fail at runtime.
                 .

src/Database/Esqueleto/Internal/Internal.hs

@@ -2618,6 +2618,15 @@ rawEsqueleto mode query = do
 -- 'from' $ \\(appointment :: 'SqlExpr' ('Entity' Appointment)) ->
 -- return ()
 -- @
+--
+-- ==== "Database.Esqueleto.Experimental":
+--
+-- @
+--  delete $ do
+--    userFeature <- from $ table @UserFeature
+--    where_ ((userFeature ^. UserFeatureFeature) `notIn` valList allKnownFeatureFlags)
+-- @
+--
 delete
     :: (MonadIO m)
     => SqlQuery ()