Update some docs for some nits found (#286)
* A few small doc clarifications
First of all, remove reference to HP as an OpenStack provider and
replace with some other examples of folks who are actually running
OpenStack Public Clouds.
Then add a few notes clarifying tenant/project usage and the fact that
domain applies to both.
* Change my-openstack.com to openstack.example.com
RFC 2606 defines example.com as a reserved domain to be used in tests
and examples. It is guaranteed to not be actually resolvable. Update
the uses of my-openstack.com to use example.com instead.
https://tools.ietf.org/html/rfc2606
* Change "cluster" to "cloud"
The general term for an installation of OpenStack is cloud, at least
when talking to end users.
* Address review comments
diff --git a/auth_options.go b/auth_options.go
index 3ee97df..7a16131 100644
--- a/auth_options.go
+++ b/auth_options.go
@@ -1,7 +1,7 @@
package gophercloud
/*
-AuthOptions stores information needed to authenticate to an OpenStack cluster.
+AuthOptions stores information needed to authenticate to an OpenStack Cloud.
You can populate one manually, or use a provider's AuthOptionsFromEnv() function
to read relevant information from the standard environment variables. Pass one
to a provider's AuthenticatedClient function to authenticate and obtain a
@@ -31,9 +31,16 @@
DomainName string `json:"name,omitempty"`
// The TenantID and TenantName fields are optional for the Identity V2 API.
+ // The same fields are known as project_id and project_name in the Identity
+ // V3 API, but are collected as TenantID and TenantName here in both cases.
// Some providers allow you to specify a TenantName instead of the TenantId.
// Some require both. Your provider's authentication policies will determine
// how these fields influence authentication.
+ // If DomainID or DomainName are provided, they will also apply to TenantName.
+ // It is not currently possible to authenticate with Username and a Domain
+ // and scope to a Project in a different Domain by using TenantName. To
+ // accomplish that, the ProjectID will need to be provided to the TenantID
+ // option.
TenantID string `json:"tenantId,omitempty"`
TenantName string `json:"tenantName,omitempty"`