Merge pull request #3203 from carapace-sh/goos-chase

docs: added v1.6

Author: rsteube

docs/book.toml

@@ -19,4 +19,4 @@ enable = true
 
 [output.linkcheck]
 follow-web-links = true
-exclude = [ 'archlinux\.org', 'github\.com']
+exclude = [ 'archlinux\.org', 'fury\.site', 'github\.com']

docs/src/SUMMARY.md

@@ -44,6 +44,7 @@
       - [carapace-generate](./development/tools/carapace-generate.md)
   - [Release Notes](./release_notes.md)
     - [v1.x](./release_notes/v1.x.md)
+    - [v1.6](./release_notes/v1.6.md)
     - [v1.5](./release_notes/v1.5.md)
     - [v1.4](./release_notes/v1.4.md)
     - [v1.3](./release_notes/v1.3.md)

docs/src/release_notes/v1.6.md

@@ -0,0 +1,69 @@
+# v1.6 - GOOS Chase
+
+![](./v1.6/banner.png)
+
+Shedding some feathers from the release.
+
+## Groups
+
+Organized completers into [groups](../groups.md).
+
+- `android` termux completers
+- `bridge` bridged completers
+- `bsd` bsd-like completers
+- `common` common completers
+- `darwin` macos completers
+- `linux` linux completers
+- `unix` unix-like completers
+- `user` user specs
+- `system` system specs
+- `windows` windows completers
+
+![](./v1.6/group.cast)
+
+## Variants
+
+Added support for [variants](../variants.md).
+
+![](./v1.6/variants.cast)
+
+## Choices
+
+The default priority of completers can be overridden with [choices](../choices.md).
+
+![](./v1.6/choices.cast)
+
+> This replaces `bridges.yaml` which now has no effect and can be removed.
+
+## Spec
+
+Added extended flag notation for less common use cases.
+
+- `nargs` amount of arguments consumed
+
+```yaml
+name: command
+commands:
+  - name: extended
+    flags:
+      --nargs-two=: {description: consumes two arguments, nargs: 2}
+      --nargs-any=: {description: consumes multiple arguments, nargs: -1}
+```
+
+![](./v1.6/extended.cast)
+
+## Diff
+
+`carapace --diff` now takes two arguments to compare [variants].
+
+![](./v1.6/diff.cast)
+
+## Aws
+
+Created [carapace-aws] to provide enriched completion for [aws-cli].
+
+![](./v1.6/aws.cast)
+
+[aws-cli]:https://github.com/aws/aws-cli
+[carapace-aws]:https://github.com/carapace-sh/carapace-aws
+[variants]:../variants.md