ENGDOCS-2382

content/reference/compose-file/services.md

@@ -257,16 +257,24 @@ cgroup_parent: m-executor-abcd
 command: bundle exec thin -p 3000
 ```
 
-The value can also be a list, in a manner similar to [Dockerfile](https://docs.docker.com/reference/dockerfile/#cmd):
-
-```yaml
-command: [ "bundle", "exec", "thin", "-p", "3000" ]
-```
-
 If the value is `null`, the default command from the image is used.
 
 If the value is `[]` (empty list) or `''` (empty string), the default command declared by the image is ignored, or in other words overridden to be empty.
 
+> [!NOTE]
+>
+> Unlike the `CMD` instruction in a Dockerfile, the `command` field doesn't automatically run within the context of the [`SHELL`](/reference/dockerfile.md#shell-form) instruction defined in the image. If your `command` relies on shell-specific features, such as environment variable expansion, you need to explicitly run it within a shell. For example:
+> 
+> ```yaml
+> command: /bin/sh -c 'echo "hello $$HOSTNAME"'
+> ```
+> 
+> If the `entrypoint` (or the image's `ENTRYPOINT`) is configured to invoke a shell, use the exec form syntax for `command` to ensure proper processing. For example:
+>
+> ```yaml
+> command: [ "bundle", "exec", "thin", "-p", "3000" ]
+> ```
+
 ### `configs`
 
 `configs` let services adapt their behaviour without the need to rebuild a Docker image. 
@@ -766,6 +774,8 @@ extends:
 - `service`: Defines the name of the service being referenced as a base, for example `web` or `database`.
 - `file`: The location of a Compose configuration file defining that service.
 
+#### Restrictions 
+
 When a service uses `extends`, it can also specify dependencies on other resources, an explicit `volumes` declaration for instance. However, it's important to note that `extends` does not automatically incorporate the target volume definition into the extending Compose file. Instead, you are responsible for ensuring that an equivalent resource exists for the service being extended to maintain consistency. Docker Compose verifies that a resource with the referenced ID is present within the Compose model.
 
 Dependencies on other resources in an `extends` target can be: