diff --git a/docs/dev/src/modules/ROOT/partials/grpc/using-acls.adoc b/docs/dev/src/modules/ROOT/partials/grpc/using-acls.adoc
new file mode 100644
index 00000000..6d8d2940
--- /dev/null
+++ b/docs/dev/src/modules/ROOT/partials/grpc/using-acls.adoc
@@ -0,0 +1,2 @@
+// this is just a placeholder so we can compile sdk docs here
+// the real file can be found in kalix-docs repo
\ No newline at end of file
diff --git a/docs/src/modules/javascript/pages/access-control.adoc b/docs/src/modules/javascript/pages/access-control.adoc
index ff2bd0eb..92e7cfa0 100644
--- a/docs/src/modules/javascript/pages/access-control.adoc
+++ b/docs/src/modules/javascript/pages/access-control.adoc
@@ -1,6 +1,8 @@
 = Access Control Lists (ACLs)
 
-This section describes functionality in the JavaScript/TypeScript SDK related to ACLs (Access Control Lists), for information about how the ACLs are defined and control access see https://docs.kalix.io/services/using-acls.html[Using ACLs].
+This section describes the practical aspects of configuring Access Control Lists (ACLs) with the JavaScript/TypeScript SDKs, if you are not sure what ACLs are or how they work, see https://docs.kalix.io/security/acls.html[Understanding ACLs] first.
+
+include::ROOT:partial$grpc/using-acls.adoc[]
 
 == Default ACL in project templates