From 829bf45c29ed595f5fff90c57d3651390ae9a6d8 Mon Sep 17 00:00:00 2001 From: Mish Ushakov <10400064+mishushakov@users.noreply.github.com> Date: Fri, 26 Jun 2026 17:40:42 +0200 Subject: [PATCH] docs: document template name format Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/template/names.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/template/names.mdx b/docs/template/names.mdx index 2a7ddc03..54ae4b3d 100644 --- a/docs/template/names.mdx +++ b/docs/template/names.mdx @@ -38,6 +38,17 @@ sandbox = Sandbox.create('my-python-env') +## Name format + +Before a name is used, it's trimmed of surrounding whitespace and lowercased. The result must match the pattern `^[a-z0-9-_]+$`: + +- Lowercase letters (`a`–`z`), numbers (`0`–`9`), dashes (`-`), and underscores (`_`) +- At least one character +- Leading and trailing dashes or underscores are allowed +- No maximum length + +Uppercase letters are accepted on input and lowercased automatically, so `My-Template` and `my-template` refer to the same name. Any other character (spaces inside the name, dots, slashes, and so on) is rejected. + ## Team-local naming Template names are scoped to your team. This means: