diff --git a/worldedit-libs/build.gradle b/worldedit-libs/build.gradle
index 983d2dc41..81d44c28c 100644
--- a/worldedit-libs/build.gradle
+++ b/worldedit-libs/build.gradle
@@ -1,5 +1,17 @@
import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
+/*
+This project shades API libraries, i.e. those libraries
+whose classes are publicly referenced from `-core` classes.
+
+This project does not shade implementation libraries, i.e.
+those libraries whose classes are internally depended on.
+
+This is because the main reason for shading those libraries is for
+their internal usage in each platform, not because we need them available to
+dependents of `-core` to compile and work with WorldEdit's API.
+
+ */
subprojects {
apply plugin: 'maven'
apply plugin: 'com.github.johnrengelman.shadow'