INTMDB-157: Add deprecation notice (#165)

* Add deprecation notice

Add deprecation notice to both programmatic key whitelist and project ip whitelist, replaced with access list.

* format to fix errors

* Added deprecated via go doc

Per https://github.com/golang/go/wiki/Deprecated added deprecated wording to alert tools that check.

* move lower in code and remove from tests

* PR comments

Co-authored-by: Gustavo Bazan <[email protected]>

Author: themantissa

mongodbatlas/project_ip_whitelist.go

@@ -11,7 +11,13 @@ const projectIPWhitelistPath = "groups/%s/whitelist"
 
 // ProjectIPWhitelistService is an interface for interfacing with the Project IP Whitelist
 // endpoints of the MongoDB Atlas API.
+//
 // See more: https://docs.atlas.mongodb.com/reference/api/whitelist/
+//
+// Deprecated: ProjectIPAccessListService replaces ProjectIPWhitelistService.
+// Atlas now refers to its cluster firewall management as IP Access Lists.
+// Atlas has deprecated the whitelist resource and will disable it in June 2021.
+// Please update any dependent work to use ProjectIPWhitelistService
 type ProjectIPWhitelistService interface {
 	List(context.Context, string, *ListOptions) ([]ProjectIPWhitelist, *Response, error)
 	Get(context.Context, string, string) (*ProjectIPWhitelist, *Response, error)

mongodbatlas/whitelist_api_keys.go

@@ -10,7 +10,13 @@ const whitelistAPIKeysPath = "orgs/%s/apiKeys/%s/whitelist"
 
 // WhitelistAPIKeysService is an interface for interfacing with the Whitelist API Keys
 // endpoints of the MongoDB Atlas API.
+//
 // See more: https://docs.atlas.mongodb.com/reference/api/apiKeys/#organization-api-key-endpoints
+//
+// Deprecated: AccessListAPIKeysService replaces WhitelistAPIKeysService.
+// Atlas now refers to programmatic API key whitelists as access lists.
+// Atlas has deprecated the whitelist method and will disable it in June 2021.
+// Please update any dependent work to use WhitelistAPIKeysService
 type WhitelistAPIKeysService interface {
 	List(context.Context, string, string, *ListOptions) (*WhitelistAPIKeys, *Response, error)
 	Get(context.Context, string, string, string) (*WhitelistAPIKey, *Response, error)