cleanup

kiln-core/src/builtin_scripts.rs

@@ -55,9 +55,11 @@ pub(crate) fn archetype_script(arch: Archetype) -> Option<&'static str> {
     }
 }
 
-/// Returns the embedded script implementing `arch` as an object, or `None` if the
-/// archetype is a plain terrain cell. The one place script-backed archetypes are
-/// declared.
+/// Returns the synthetic `BUILTIN_*` compile-key for `arch`'s embedded script, or
+/// `None` if the archetype is a plain terrain cell. [`Board::expand_builtin_archetypes`](crate::board::Board::expand_builtin_archetypes)
+/// stores this as the expanded object's `script_name` so every instance of a
+/// script-backed archetype shares one compiled AST (the source comes from
+/// [`archetype_script`]).
 pub(crate) fn archetype_script_key(arch: Archetype) -> Option<&'static str> {
     match arch {
         Archetype::Pusher(_) => Some("BUILTIN_pusher"),