Small documentation fixes for Atlas Deployments (#619)

* Fix documentation

* Update atlas.mongodb.com_atlasdeployments.yaml

Author: Julien-Ben

config/crd/bases/atlas.mongodb.com_atlasdeployments.yaml

@@ -35,9 +35,12 @@ spec:
             type: object
           spec:
             description: AtlasDeploymentSpec defines the desired state of AtlasDeployment
+              Only one of DeploymentSpec, AdvancedDeploymentSpec and ServerlessSpec
+              should be defined
             properties:
               advancedDeploymentSpec:
-                description: Configuration for the advanced deployment API. https://docs.atlas.mongodb.com/reference/api/clusters-advanced/
+                description: Configuration for the advanced (v1.5) deployment API
+                  https://www.mongodb.com/docs/atlas/reference/api/clusters-advanced/
                 properties:
                   backupEnabled:
                     type: boolean
@@ -270,7 +273,7 @@ spec:
                 - name
                 type: object
               deploymentSpec:
-                description: Configuration for the advanced deployment API
+                description: Configuration for the normal (v1) deployment API https://www.mongodb.com/docs/atlas/reference/api/clusters/
                 properties:
                   autoScaling:
                     description: Collection of settings that configures auto-scaling
@@ -602,7 +605,7 @@ spec:
                 - name
                 type: object
               serverlessSpec:
-                description: Configuration for the advanced deployment API. https://docs.atlas.mongodb.com/reference/api/clusters-advanced/
+                description: Configuration for the serverless deployment API. https://www.mongodb.com/docs/atlas/reference/api/serverless-instances/
                 properties:
                   name:
                     description: Name of the serverless deployment as it appears in

pkg/api/v1/atlasdeployment_types.go

@@ -44,23 +44,24 @@ const (
 )
 
 // AtlasDeploymentSpec defines the desired state of AtlasDeployment
+// Only one of DeploymentSpec, AdvancedDeploymentSpec and ServerlessSpec should be defined
 type AtlasDeploymentSpec struct {
 	// Project is a reference to AtlasProject resource the deployment belongs to
 	Project common.ResourceRefNamespaced `json:"projectRef"`
 
-	// Configuration for the advanced deployment API
+	// Configuration for the normal (v1) deployment API https://www.mongodb.com/docs/atlas/reference/api/clusters/
 	// +optional
 	DeploymentSpec *DeploymentSpec `json:"deploymentSpec,omitempty"`
 
-	// Configuration for the advanced deployment API. https://docs.atlas.mongodb.com/reference/api/clusters-advanced/
+	// Configuration for the advanced (v1.5) deployment API https://www.mongodb.com/docs/atlas/reference/api/clusters-advanced/
 	// +optional
 	AdvancedDeploymentSpec *AdvancedDeploymentSpec `json:"advancedDeploymentSpec,omitempty"`
 
 	// Backup schedule for the AtlasDeployment
 	// +optional
 	BackupScheduleRef common.ResourceRefNamespaced `json:"backupRef"`
 
-	// Configuration for the advanced deployment API. https://docs.atlas.mongodb.com/reference/api/clusters-advanced/
+	// Configuration for the serverless deployment API. https://www.mongodb.com/docs/atlas/reference/api/serverless-instances/
 	// +optional
 	ServerlessSpec *ServerlessSpec `json:"serverlessSpec,omitempty"`