feat: Group experimentation commands under experimentation

docs/auth0_experimentation.md

@@ -0,0 +1,16 @@
+---
+layout: default
+has_toc: false
+---
+# auth0 experimentation
+
+Manage Auth0 Experiment Center resources: feature flags, segments, and experiments.
+
+Feature flags define named parameters that experiments vary across user groups, segments group users by matching rules, and experiments run A/B tests by tying a feature flag, its variations, and traffic allocations together.
+
+## Commands
+
+- [auth0 experimentation experiments](auth0_experimentation_experiments.md) - Manage experimentation experiments
+- [auth0 experimentation feature-flags](auth0_experimentation_feature-flags.md) - Manage experimentation feature flags
+- [auth0 experimentation segments](auth0_experimentation_segments.md) - Manage experimentation segments
+

docs/auth0_experimentation_experiments.md

@@ -0,0 +1,26 @@
+---
+layout: default
+has_toc: false
+has_children: true
+---
+# auth0 experimentation experiments
+
+Experiments run A/B tests by tying a feature flag, its variations, and traffic allocations together.
+
+Typical workflow:
+  1. Create a feature flag and its variations
+  2. Optionally create segments for targeted allocation
+  3. Create an experiment
+  4. Validate it
+  5. Start it
+
+## Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+

docs/auth0_experimentation_experiments_create.md

@@ -0,0 +1,62 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments create
+
+Create a new experiment.
+
+To create interactively, use `auth0 experimentation experiments create` with no flags.
+
+To create non-interactively, supply all required flags.
+
+## Usage
+```
+auth0 experimentation experiments create [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments create
+  auth0 experimentation experiments create --name "button-color" --feature-flag-id ff_abc --authentication-flow login --allocation-strategy percentage --assignment-config '{"subject":"device"}' --allocations '[{"variation_id":"vid_1","weight":50,"is_control":true},{"variation_id":"vid_2","weight":50,"is_control":false}]'
+```
+
+
+## Flags
+
+```
+  -s, --allocation-strategy string   Allocation strategy: percentage or segment.
+      --allocations string           JSON array of allocation items ({variation_id, weight, is_control} for percentage, where weight is an integer percentage from 1 to 100; {variation_id, segment_id, is_control} for segment).
+      --assignment-config string     JSON object configuring how users are assigned to variations (e.g. '{"subject":"device"}').
+  -a, --authentication-flow string   Authentication flow this experiment applies to (e.g. login, signup).
+  -d, --description string           Description of the experiment.
+  -f, --feature-flag-id string       ID of the feature flag to experiment on.
+      --json                         Output in json format.
+      --json-compact                 Output in compact json format.
+  -n, --name string                  Name of the experiment.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+

docs/auth0_experimentation_experiments_delete.md

@@ -0,0 +1,55 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments delete
+
+Delete an experiment.
+
+Active experiments must be paused or completed before deleting.
+
+To delete non-interactively, supply the experiment ID and use `--force` to skip confirmation.
+
+## Usage
+```
+auth0 experimentation experiments delete [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments delete
+  auth0 experimentation experiments delete <experiment-id>
+  auth0 experimentation experiments delete <experiment-id> --force
+```
+
+
+## Flags
+
+```
+      --force   Skip confirmation.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+

docs/auth0_experimentation_experiments_list.md

@@ -0,0 +1,58 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments list
+
+List all experiments. To create one, run: `auth0 experimentation experiments create`.
+
+## Usage
+```
+auth0 experimentation experiments list [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments list
+  auth0 experimentation experiments ls
+  auth0 experimentation experiments list --json
+  auth0 experimentation experiments list --status active
+  auth0 experimentation experiments list --feature-flag-id <id>
+```
+
+
+## Flags
+
+```
+      --authentication-flow string   Filter by authentication flow.
+      --csv                          Output in csv format.
+      --feature-flag-id string       Filter by feature flag ID.
+      --json                         Output in json format.
+      --json-compact                 Output in compact json format.
+      --status string                Filter by status (draft, active, paused, completed, archived).
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+

docs/auth0_experimentation_experiments_show.md

@@ -0,0 +1,52 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments show
+
+Display details about an experiment including its allocations and validation status.
+
+## Usage
+```
+auth0 experimentation experiments show [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments show
+  auth0 experimentation experiments show <experiment-id>
+  auth0 experimentation experiments show <experiment-id> --json
+```
+
+
+## Flags
+
+```
+      --json           Output in json format.
+      --json-compact   Output in compact json format.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+

docs/auth0_experimentation_experiments_status.md

@@ -0,0 +1,60 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments status
+
+Transition an experiment to a new lifecycle status: active, paused, completed, or archived.
+
+  • active    — start (or resume) the experiment; runs full validation before activating
+  • paused    — pause a running experiment; it can be resumed by setting it active again
+  • completed — mark the experiment as finished; it can then be archived
+  • archived  — archive a completed experiment
+
+To set the status interactively, run `auth0 experimentation experiments status` with no arguments.
+
+## Usage
+```
+auth0 experimentation experiments status [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments status
+  auth0 experimentation experiments status <experiment-id>
+  auth0 experimentation experiments status <experiment-id> active
+  auth0 experimentation experiments status <experiment-id> paused
+```
+
+
+## Flags
+
+```
+      --json           Output in json format.
+      --json-compact   Output in compact json format.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+

docs/auth0_experimentation_experiments_update.md

@@ -0,0 +1,62 @@
+---
+layout: default
+parent: auth0 experimentation experiments
+has_toc: false
+---
+# auth0 experimentation experiments update
+
+Update an experiment.
+
+Note: feature flag, authentication flow, and allocation strategy cannot be changed after creation. To change an experiment's status, use `auth0 experimentation experiments status`.
+
+To update interactively, use `auth0 experimentation experiments update` with no arguments.
+
+## Usage
+```
+auth0 experimentation experiments update [flags]
+```
+
+## Examples
+
+```
+  auth0 experimentation experiments update
+  auth0 experimentation experiments update <experiment-id>
+  auth0 experimentation experiments update <experiment-id> --name "new-name"
+  auth0 experimentation experiments update <experiment-id> --assignment-config '{"subject":"device"}'
+  auth0 experimentation experiments update <experiment-id> --allocations '[{"variation_id":"vid","weight":100,"is_control":true}]'
+```
+
+
+## Flags
+
+```
+      --allocations string         JSON array of allocation items ({variation_id, weight, is_control} for percentage, where weight is an integer percentage from 1 to 100; {variation_id, segment_id, is_control} for segment).
+      --assignment-config string   JSON object configuring how users are assigned to variations (e.g. '{"subject":"device"}').
+  -d, --description string         Description of the experiment.
+      --json                       Output in json format.
+      --json-compact               Output in compact json format.
+  -n, --name string                Name of the experiment.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 experimentation experiments create](auth0_experimentation_experiments_create.md) - Create a new experiment
+- [auth0 experimentation experiments delete](auth0_experimentation_experiments_delete.md) - Delete an experiment
+- [auth0 experimentation experiments list](auth0_experimentation_experiments_list.md) - List your experiments
+- [auth0 experimentation experiments show](auth0_experimentation_experiments_show.md) - Show an experiment
+- [auth0 experimentation experiments status](auth0_experimentation_experiments_status.md) - Change an experiment's status
+- [auth0 experimentation experiments update](auth0_experimentation_experiments_update.md) - Update an experiment
+- [auth0 experimentation experiments validate](auth0_experimentation_experiments_validate.md) - Validate an experiment
+
+