From 6741446bde5dd563453d8816d6825d6c6cb697fb Mon Sep 17 00:00:00 2001
From: Lukas Holecek <lholecek@redhat.com>
Date: Jun 19 2018 15:31:11 +0000
Subject: Update Release Notes for next release


---

diff --git a/docs/release-notes.rst b/docs/release-notes.rst
index 7944a1a..37cf294 100644
--- a/docs/release-notes.rst
+++ b/docs/release-notes.rst
@@ -2,6 +2,34 @@
 Release Notes
 =============
 
+Next Release
+============
+
+* New endpoint :http:post:`/api/v1.0/waivers/+filtered` deprecates
+  :http:post:`/api/v1.0/waivers/+by-subjects-and-testcases`. This allows
+  posting an arbitrary set of filter criteria, instead of the using a
+  complicated and limited API.
+
+* New attributes `subject_type` and `subject_identifier` deprecate `subject`
+  (`<https://pagure.io/greenwave/issue/126>`__). The `subject` is kept for
+  backwards compatibility.
+
+* The :program:`waiverdb-cli` utility will now guess a suitable default value
+  for the :option:`--product-version` option in many common cases, in order to
+  make it easier to submit waivers (#111). Automated scripts should prefer to
+  explicitly pass :option:`--product-version` in case the guessing logic does
+  not work in all cases.
+
+* Previously, when you requested a list of waivers, WaiverDB would consider
+  waivers from unrelated users and product versions to obsolete each other. The
+  API now correctly returns the most recent waiver from each user, and for each
+  product version.
+
+* The documentation now includes a section describing how end users can submit
+  waivers using the command-line interface (see :ref:`user-guide`, #149).
+
+* New man page available for ``waiverdb-client.conf(5)`` (see :ref:`client-conf`).
+
 WaiverDB 0.10
 =============
 
diff --git a/docs/user-guide.rst b/docs/user-guide.rst
index d67ea21..fdf580b 100644
--- a/docs/user-guide.rst
+++ b/docs/user-guide.rst
@@ -1,3 +1,5 @@
+.. _user-guide:
+
 ==========
 User Guide
 ==========