docs: Condense locals documentation by 60% for clarity

examples/locals/README.md

@@ -2,154 +2,34 @@
 
 Reduce repetition and build computed values using file-scoped locals.
 
-Learn more about [Locals](https://atmos.tools/core-concepts/stacks/locals/).
+Learn more about [Locals](https://atmos.tools/stacks/locals).
 
 ## What You'll See
 
 - **Basic locals**: Define reusable values within a file
 - **Dependency resolution**: Locals can reference other locals
-- **Context access**: Locals can access `settings`, `vars`, and `env`
-- **Computed values**: Build complex values from simpler components
+- **Context access**: Locals can access `settings`, `vars`, and `env` from the same file
+- **File-scoped isolation**: Each stack file has independent locals
 
 ## Try It
 
 ```shell
 cd examples/locals
 
-# View the resolved locals defined in the `dev` stack
-atmos describe locals --stack dev
+# View resolved locals for the dev stack
+atmos describe locals -s dev
 
-# View the resolved locals defined in the `prod` stack
-atmos describe locals -s prod
+# View resolved locals for a specific component
+atmos describe locals myapp -s dev
 
-# View the resolved locals for the `myapp` component in the `dev` stack
-atmos describe locals myapp --stack dev
-
-# View the resolved locals for the `myapp` component in the `prod` stack
-atmos describe locals myapp --stack prod
-
-# View the resolved variables for the `myapp` component in `dev` stack
-atmos list vars myapp --stack dev
-
-# View the resolved variables for the `myapp` component in `prod` stack
-atmos list vars myapp --stack prod
-
-# View the full `myapp` component configuration in `dev` stack
-atmos describe component myapp -s dev
-
-# View the full `myapp` component configuration in `prod` stack
-atmos describe component myapp -s prod
-```
-
-## Example Output
-
-The output below shows the resolved `locals` defined in the `dev` stack:
-
-```shell
-$ atmos describe locals --stack dev
-```
-
-```yaml
-locals:
-  app_version: v1
-  default_tags:
-    Environment: development
-    ManagedBy: Atmos
-    Namespace: acme
-    Team: platform
-  environment: development
-  full_name: acme-development-dev
-  name_prefix: acme-development
-  namespace: acme
-  stage_name: dev
-```
-
-The output below shows the resolved `locals` for the `myapp` component in the `dev` stack:
-
-```shell
-$ atmos describe locals myapp --stack dev
-```
-
-```yaml
-components:
-  terraform:
-    myapp:
-      locals:
-        app_version: v1
-        default_tags:
-          Environment: development
-          ManagedBy: Atmos
-          Namespace: acme
-          Team: platform
-        environment: development
-        full_name: acme-development-dev
-        name_prefix: acme-development
-        namespace: acme
-        stage_name: dev
-```
-
-The output below shows the resolved variables for the `myapp` component in the `dev` stack:
-
-```shell
-$ atmos list vars myapp -s dev
-```
-
-```text
-Key          dev
-────────────────────────────────────
- environment  development
- full_name    acme-development-dev
- name         acme
- stage        dev
+# Compare dev vs prod
+atmos describe locals myapp -s prod
 ```
 
-## Key Concepts
-
-### Locals Reference Other Locals
-
-```yaml
-locals:
-  namespace: acme
-  environment: dev
-  # Reference other locals
-  full_name: "{{ .locals.namespace }}-{{ .locals.environment }}"
-```
-
-### Locals Compose Values from Settings and Vars
-
-```yaml
-settings:
-  team: platform
-
-vars:
-  stage: dev
-
-locals:
-  namespace: acme
-
-  # Compose values from settings, vars, and other locals
-  resource_prefix: "{{ .locals.namespace }}-{{ .vars.stage }}"
-  owner_tag: "{{ .settings.team }}-team"
-
-  # Build a tags map combining multiple sources
-  default_tags:
-    Namespace: "{{ .locals.namespace }}"
-    Stage: "{{ .vars.stage }}"
-    Owner: "{{ .locals.owner_tag }}"
-```
-
-### File-Scoped Isolation
-
-Locals are scoped to the file where they are defined. This means:
-
-- Locals defined in `dev.yaml` cannot be accessed from other files.
-- Each file has its own independent `locals` scope.
-- Use `vars` or `settings` for values that need to be shared across files.
-
 ## Key Files
 
-| File                                 | Purpose                       |
-|--------------------------------------|-------------------------------|
-| `stacks/deploy/dev.yaml`             | Development stack with locals |
-| `stacks/deploy/prod.yaml`            | Production stack with locals  |
-| `components/terraform/myapp/main.tf` | Terraform component           |
+| File | Purpose |
+|------|---------|
+| `stacks/deploy/dev.yaml` | Development stack with locals |
+| `stacks/deploy/prod.yaml` | Production stack with locals |
+| `components/terraform/myapp/main.tf` | Terraform component |