docs: add docs about name expansion

Author: ekristen

docs/features/name-expansion.md

@@ -0,0 +1,51 @@
+# Name Expansion
+
+This allows you to use wildcards in the resource names to match multiple resources. This is primarily useful when you
+want to target a group of resource type for either inclusion or exclusion. 
+
+Resource Name expansion is valid for use in the following areas:
+
+!!! warning
+This feature is currently **NOT** supported in filters.
+
+- cli includes/excludes
+- config resource types includes/excludes
+- account resource types includes/excludes
+
+## Examples
+
+### CLI
+
+```console
+aws-nuke run --config config.yaml --include "Cognito*"
+```
+
+This can also be used with `resource-types` subcommand to see what resource types are available, and you can specify
+multiple wildcard arguments.
+
+```console
+aws-nuke resource-types "Cognito*" "IAM*"
+```
+
+### Config
+
+```yaml
+resource-types:
+  includes:
+    - "Cognito*"
+  excludes:
+    - "OpsWorks*"
+```
+
+### Account Config
+
+```yaml
+accounts:
+  '012345678912':
+    resource-types:
+      includes:
+        - "Cognito*"
+      excludes:
+        - "OpsWorks*"
+```
+

docs/features/overview.md

@@ -6,6 +6,8 @@ Some of the new features include:
 - [Run Against All Enabled Regions](enabled-regions.md)
 - [Bypass Alias Check - Allow the skip of an alias on an account](bypass-alias-check.md)
 - [Signed Binaries](signed-binaries.md)
+- [Filter Groups (Experimental)](filter-groups.md)
+- [Name Expansion](name-expansion.md)
 
 Additionally, there are a few new sub commands to the tool to help with setup and debugging purposes:
 

docs/index.md

@@ -18,6 +18,7 @@ This is not a comprehensive list, but here are some of the highlights:
 * New Feature: [Run Against All Enabled Regions](features/enabled-regions.md)
 * New Feature: [Bypass Alias Check - Allow the skip of an alias on an account](features/bypass-alias-check.md)
 * New Feature: [Filter Groups (Experimental)](features/filter-groups.md)
+* New Feature: [Name Expansion](features/name-expansion.md)
 * Breaking Change: `root` command no longer triggers the run, must use subcommand `run` (alias: `nuke`)
 * Completely rewrote the core of the tool as a dedicated library [libnuke](https://github.com/ekristen/libnuke)
   * This library has over 95% test coverage which makes iteration and new features easier to implement.

mkdocs.yml

@@ -79,6 +79,7 @@ nav:
     - Global Filters: features/global-filters.md
     - Filter Groups: features/filter-groups.md
     - Enabled Regions: features/enabled-regions.md
+    - Name Expansion: features/name-expansion.md
     - Signed Binaries: features/signed-binaries.md
   - CLI:
     - Usage: cli-usage.md