diff --git a/website/docs/4-guides/1-deployments/1-deploy-app.md b/website/docs/4-guides/1-deployments/1-deploy-app.md
index 9b68284c..ee802ab6 100644
--- a/website/docs/4-guides/1-deployments/1-deploy-app.md
+++ b/website/docs/4-guides/1-deployments/1-deploy-app.md
@@ -98,9 +98,10 @@ You can pass additional build arguments or override existing ones using the `--b
 uc deploy --build-arg BUILD_ENV=dev
 ```
 
-You can also use advanced features like build caches, secrets, and SSH access.
+You can also use advanced features like build caches or SSH access.
 See [Compose Build Specification](https://github.com/compose-spec/compose-spec/blob/main/build.md) for all supported
-attributes.
+attributes. Note that build [secrets](https://github.com/compose-spec/compose-spec/blob/main/build.md#secrets) are not
+supported though.
 
 :::info note
 
@@ -140,8 +141,8 @@ This generates tags like:
 `uc deploy` renders the image templates when it loads the Compose file and then uses the resulting names for the build
 and deploy stages.
 
-See the [Image tag template](../../8-compose-file-reference/2-image-tag-template.md) reference for all available template
-variables and functions.
+See the [Image tag template](../../8-compose-file-reference/2-image-tag-template.md) reference for all available
+template variables and functions.
 
 ### Separate build and deploy steps