Remove databases info from top-level godoc string

Removes the managed databases info from the top-level godoc string.
Having this string there, when no other product specific info is
there, is confusing. This PR moves this down to the `DatabaseService`
godoc string instead in order to be more consistent with the rest of
the library.
This commit is contained in:
Ben Tranter 2019-11-25 16:33:11 -05:00
parent fa6f5161bb
commit ecf6ce400f
No known key found for this signature in database
GPG Key ID: 429E631AAAB71BAE
2 changed files with 9 additions and 12 deletions

View File

@ -68,8 +68,14 @@ const (
SQLAuthPluginCachingSHA2 = "caching_sha2_password"
)
// DatabasesService is an interface for interfacing with the databases endpoints
// of the DigitalOcean API.
// The DatabasesService provides access to the DigitalOcean managed database
// suite of products through the public API. Customers can create new database
// clusters, migrate them between regions, create replicas and interact with
// their configurations. Each database service is refered to as a Database. A
// SQL database service can have multiple databases residing in the system. To
// help make these entities distinct from Databases in godo, we refer to them
// here as DatabaseDBs.
//
// See: https://developers.digitalocean.com/documentation/v2#databases
type DatabasesService interface {
List(context.Context, *ListOptions) ([]Database, *Response, error)

11
doc.go
View File

@ -1,11 +1,2 @@
// Package godo is the DigtalOcean API v2 client for Go
//
// Databases
//
// The Databases service provides access to the DigitalOcean managed database
// suite of products. Customers can create new database clusters, migrate them
// between regions, create replicas and interact with their configurations.
// Each database service is refered to as a Database. A SQL database service
// can have multiple databases residing in the system. To help make these
// entities distinct from Databases in godo, we refer to them here as DatabaseDBs.
// Package godo is the DigtalOcean API v2 client for Go.
package godo