diff --git a/docs/src/content/docs/guides/roblox.mdx b/docs/src/content/docs/guides/roblox.mdx
index 5994baa..d9723e3 100644
--- a/docs/src/content/docs/guides/roblox.mdx
+++ b/docs/src/content/docs/guides/roblox.mdx
@@ -190,9 +190,11 @@ In Wally, it is standard to have a `default.project.json` with the following:
 This will cause the `src` directory to be directly synced into Roblox.
 
 In pesde, you should not have a `default.project.json` file in your package.
-Instead, you use the `build_files` field to specify what should be synced. This
-allows the consumer of your package to choose the sync tool they want to use,
-instead of being constrained to only using Rojo.
+Instead, you are required to use the `build_files` field to specify a 1:1 match
+between Roblox and the file system. pesde forbids `default.project.json` to be
+part of a published package, and regenerates it when installing a pesde git
+dependency. This allows the consumer of your package to choose the sync tool
+they want to use, instead of being constrained to only using Rojo.
 
 This has the effect that the structure of the files in the file system ends up
 being reflected inside Roblox.