diff --git a/cli/domain/domain.go b/cli/domain/domain.go index 06d4e821..0094d9b5 100644 --- a/cli/domain/domain.go +++ b/cli/domain/domain.go @@ -11,14 +11,18 @@ var DomainCommand = &cli.Command{ Aliases: []string{"d"}, ArgsUsage: "", Description: ` -This command supports managing DNS records via 3rd party providers such as -Gandi DNS. It supports listing, creating, updating and removing all types of -DNS records that you might need for managing Co-op Cloud apps. +This command supports managing domain name records via 3rd party providers such +as Gandi DNS. It supports listing, creating, updating and removing all types of +records that you might need for managing Co-op Cloud apps. The following providers are supported: Gandi DNS https://www.gandi.net +You need an account with such a provider already. Typically, you need to +provide an API token on the Abra command-line when using these commands so that +you can authenticate with your provider account. + Any new provider can be integrated, we welcome change sets. See the underlying DNS library documentation for more. It supports many existing providers and allows to implement new provider support easily. diff --git a/cli/domain/list.go b/cli/domain/list.go index 0bfd73e2..98ff9d45 100644 --- a/cli/domain/list.go +++ b/cli/domain/list.go @@ -16,18 +16,17 @@ import ( // DomainListCommand lists domains. var DomainListCommand = &cli.Command{ Name: "list", - Usage: "List domains", + Usage: "List domain name records for a zone", Aliases: []string{"ls"}, ArgsUsage: "", Flags: []cli.Flag{ internal.DNSProviderFlag, }, Description: ` -This command lists all domains managed by a 3rd party provider. +This command lists all domain name records managed by a 3rd party provider. -You must specify a zone (e.g. example.com) under which your DNS entries are -listed. This zone must already be created via the provider web interface or -using "abra domain create". +You must specify a zone (e.g. example.com) under which your domain name records +are listed. This zone must already be created on your provider account. `, Action: func(c *cli.Context) error { zone := c.Args().First()