Backport of Document the deprecation of include_terminated into relea…

…se/0.16.x (#4829)

* backport of commit ceb3cf2

* Adding changelog info

---------

Co-authored-by: Todd <github@quaddi.com>

CHANGELOG.md

@@ -4,6 +4,18 @@ Canonical reference for changes, improvements, and bugfixes for Boundary.
 
 ## Next
 
+### Deprecations/Changes
+
+* The `boundary daemon` command has been deprecated in favor of the new
+  `boundary cache` command. The behavior remains the same. The `boundary search`
+  command is unchanged.
+  ([PR](https://github.com/hashicorp/boundary/pull/4808))
+* The include_terminated field in the list sessions request will be removed
+  in an upcoming release. After the deprecation process is complete and the
+  field is removed terminated sessions will be returned
+  in all list session responses unless filtered out using the filter field.
+  ([PR](https://github.com/hashicorp/boundary/pull/4602))
+
 ### Bug Fixes
 
 * Fix a dead lock issue where the controller could get stuck with all of its

internal/gen/controller.swagger.json

@@ -4221,7 +4221,7 @@
           },
           {
             "name": "include_terminated",
-            "description": "Experimental. By default only non-terminated (i.e. pending, active, canceling) are returned.\nSet this option to include terminated sessions as well.",
+            "description": "Deprecated. Should be removed in 0.18.0 since pagination removes the need\nfor the optimization that this provided.\nBy default only non-terminated (i.e. pending, active, canceling) are returned.\nSet this option to include terminated sessions as well.  If not set paginated\nresponses may not include terminated sessions either in the response or in\nthe removed_ids.",
             "in": "query",
             "required": false,
             "type": "boolean"