docs: fix remaining documentation issues from PR #2245 review

Agent-Logs-Url: https://github.com/cloudposse/atmos/sessions/bc75a042-a0e2-438d-ab72-433d1c692636

Co-authored-by: nitrocode <7775707+nitrocode@users.noreply.github.com>

Author: Copilot

website/docs/cli/configuration-overview.mdx

@@ -141,7 +141,7 @@ spec:
   sources:
     - component: vpc
       source: github.com/cloudposse-terraform-components/aws-vpc.git//src
-      version: 1.300.0
+      version: "v1.537.0"
 ```
 
 [Learn more about Vendoring →](/vendor/)

website/docs/vendor/component-manifest/source.mdx

@@ -39,7 +39,7 @@ spec:
 
     To vendor a module from a Git repo, use the following format:
     ```
-    github.com/cloudposse-terraform-components/aws-vpc.git//src?ref={{.Version}}
+    github.com/cloudposse-terraform-components/aws-<component>.git//src?ref={{.Version}}
     ```
   </dd>
 

website/docs/vendor/config/imports.mdx

@@ -149,7 +149,7 @@ spec:
   sources:
     - component: "my-vpc4"
       source: "github.com/cloudposse-terraform-components/aws-vpc.git//src?ref={{.Version}}"
-      version: "1.535.0"
+      version: "v1.535.0"
       targets:
         - "components/terraform/infra/my-vpc4"
 ```
@@ -170,11 +170,11 @@ are defined:
 > atmos vendor pull
 
 Processing vendor config file 'vendor.yaml'
-Pulling sources for the component 'my-vpc6' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=1.533.0' into 'components/terraform/infra/my-vpc6'
-Pulling sources for the component 'my-vpc5' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=1.534.0' into 'components/terraform/infra/my-vpc5'
-Pulling sources for the component 'my-vpc4' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=1.535.0' into 'components/terraform/infra/my-vpc4'
+Pulling sources for the component 'my-vpc6' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.533.0' into 'components/terraform/infra/my-vpc6'
+Pulling sources for the component 'my-vpc5' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.534.0' into 'components/terraform/infra/my-vpc5'
+Pulling sources for the component 'my-vpc4' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.535.0' into 'components/terraform/infra/my-vpc4'
 Pulling sources for the component 'my-vpc1' from 'public.ecr.aws/cloudposse/components/terraform/stable/aws/vpc:1.0.2' into 'components/terraform/infra/my-vpc1'
-Pulling sources for the component 'my-vpc2' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=1.536.0' into 'components/terraform/infra/my-vpc2'
+Pulling sources for the component 'my-vpc2' from 'github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.536.0' into 'components/terraform/infra/my-vpc2'
 Pulling sources for the component 'vpc' from 'public.ecr.aws/cloudposse/components/terraform/stable/aws/vpc:latest' into 'components/terraform/infra/vpc3'
 Pulling sources for the component 'vpc-flow-logs-bucket' from 'github.com/cloudposse-terraform-components/aws-vpc-flow-logs-bucket.git//src?ref=v1.537.0' into 'components/terraform/infra/vpc-flow-logs-bucket/v1.537.0'
 ```

website/docs/vendor/url-syntax.mdx

@@ -56,10 +56,10 @@ The double-slash (`//`) is a special delimiter (not a path separator) that separ
 
   <TabItem value="root" label="Root Directory">
     ```yaml
-    source: "github.com/cloudposse-terraform-components/aws-s3-bucket.git//.?ref=v1.541.1"
+    source: "github.com/cloudposse-terraform-components/aws-s3-bucket.git//src?ref=v1.541.1"
     ```
 
-    **Result:** Clones the repository and uses the root directory (`.` means current directory).
+    **Result:** Clones the repository and extracts the `src` subdirectory (where Terraform files reside in `cloudposse-terraform-components` repos).
   </TabItem>
 
   <TabItem value="no-delimiter" label="Without Delimiter">
@@ -68,6 +68,10 @@ The double-slash (`//`) is a special delimiter (not a path separator) that separ
     ```
 
     **Result:** For Git URLs without a subdirectory, Atmos automatically adds `//.` for you (root of repository).
+
+    :::caution cloudposse-terraform-components repos
+    For `cloudposse-terraform-components` repos, always specify `//src` explicitly — Terraform files reside in the `src/` subdirectory, not the repository root.
+    :::
   </TabItem>
 </Tabs>
 
@@ -126,13 +130,13 @@ Atmos automatically adds `depth=1` to Git clones for faster downloads. You can o
 
   <TabItem value="commit" label="Git Commit SHA">
     ```yaml
-    source: "github.com/cloudposse-terraform-components/aws-vpc.git?ref=a1b2c3d4"
+    source: "github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=a1b2c3d4"
     ```
   </TabItem>
 
   <TabItem value="depth" label="Custom Clone Depth">
     ```yaml
-    source: "github.com/cloudposse-terraform-components/aws-vpc.git?ref=main&depth=10"
+    source: "github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.539.0&depth=10"
     ```
   </TabItem>
 </Tabs>
@@ -163,10 +167,10 @@ source: "git::https://github.com/cloudposse/atmos.git//examples?ref=main"
 ### SSH Authentication
 ```yaml
 # SSH protocol (requires SSH key setup)
-source: "git::ssh://git@github.com/cloudposse-terraform-components/aws-vpc.git?ref=v1.539.0"
+source: "git::ssh://git@github.com/cloudposse-terraform-components/aws-vpc.git//src?ref=v1.539.0"
 
 # Or SCP-style shorthand
-source: "git@github.com:cloudposse-terraform-components/aws-vpc.git?ref=v1.539.0"
+source: "git@github.com:cloudposse-terraform-components/aws-vpc.git//src?ref=v1.539.0"
 ```
 
 ### With Credentials (Not Recommended)