Add AWS CLI Requires Groff Executable as an AWS TIL

README.md

@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://crafty-builder-6996.ck.page/e169c61186).
 
-_1590 TILs and counting..._
+_1591 TILs and counting..._
 
 See some of the other learning resources I work on:
 - [Ruby Operator Lookup](https://www.visualmode.dev/ruby-operators)
@@ -24,6 +24,7 @@ See some of the other learning resources I work on:
 * [Amplify](#amplify)
 * [Ansible](#ansible)
 * [Astro](#astro)
+* [AWS](#aws)
 * [Brew](#brew)
 * [Chrome](#chrome)
 * [Clojure](#clojure)
@@ -110,6 +111,10 @@ See some of the other learning resources I work on:
 - [Generate Types For A Content Collection](astro/generate-types-for-a-content-collection.md)
 - [Markdown Files Are Of Type MarkdownInstance](astro/markdown-files-are-of-type-markdown-instance.md)
 
+### AWS
+
+- [AWS CLI Requires Groff Executable](aws/aws-cli-requires-groff-executable.md)
+
 ### Brew
 
 - [Configure Brew Environment Variables](brew/configure-brew-environment-variables.md)

aws/aws-cli-requires-groff-executable.md

@@ -0,0 +1,29 @@
+# AWS CLI Requires Groff Executable
+
+I have the AWS CLI installed on this machine, but when I went to run certain
+commands like `aws logs tail my_log_group` or even `aws logs tail help`, I'd
+get the following error:
+
+```
+$ aws logs tail help
+
+Could not find executable named 'groff'
+```
+
+This may only be an issue on MacOS Ventura for older versions of the CLI, per
+[this PR](https://github.com/aws/aws-cli/pull/7413):
+
+> The CLI's help commands are currently broken on macOS Ventura because Ventura has replaced groff with mandoc. This PR fixes the issue by falling back on mandoc if groff doesn't exist in the path.
+
+There are two ways of dealing with this. One would be to install the missing dependency:
+
+```bash
+$ brew install groff
+```
+
+The other is to update the AWS CLI to one that falls back to `mandoc`.
+Depending on how you originally installed the AWS CLI, you can either [follow
+their official install/upgrade
+instructions](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html),
+`pip install --upgrade awscli`, or upgrade view homebrew (`brew upgrade
+awscli`).