diff --git a/jekyll/_cci2/workspaces.adoc b/jekyll/_cci2/workspaces.adoc
index 923f0e8e3d..c25d9701c5 100644
--- a/jekyll/_cci2/workspaces.adoc
+++ b/jekyll/_cci2/workspaces.adoc
@@ -34,6 +34,7 @@ Some notes about workspaces:
 * When attaching a workspace the "layer" from each upstream job is applied in the order the upstream jobs appear in the workflow graph. When two jobs run concurrently, the order in which their layers are applied is undefined.
 * If multiple concurrent jobs persist the same filename, then attaching the workspace will error.
 * If a workflow is re-run, it inherits the same workspace as the original workflow. When re-running failed jobs, only the re-run jobs will see the same workspace content as the jobs in the original workflow.
+* Workspaces don't fully work with parallelism, as environment variables like `$CIRCLE_NODE_INDEX` are not available in the `persist_to_workspace` step. Therefore, it's not possible to save files with non-conflicting names from the multiple parallel runs of the job.
 
 By default, on CircleCI cloud, workspace storage duration is set to 15 days. This can be customized on the link:https://app.circleci.com/[CircleCI web app] by navigating to menu:Plan[Usage Controls]. Currently, 15 days is also the maximum storage duration you can set.