From 1fa57ea6c8dcf01c7084b3c96899cd774931aaae Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Thu, 1 Oct 2026 09:45:20 -0400 Subject: [PATCH 1/2] Document editing project text files --- .../features/workspace/code-editor.mdx | 6 +++++- .../features/workspace/file-explorer.mdx | 11 +++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/content/pages/docs/zoo-design-studio/features/workspace/code-editor.mdx b/content/pages/docs/zoo-design-studio/features/workspace/code-editor.mdx index 5745ffb42..045ad83e6 100644 --- a/content/pages/docs/zoo-design-studio/features/workspace/code-editor.mdx +++ b/content/pages/docs/zoo-design-studio/features/workspace/code-editor.mdx @@ -1,10 +1,12 @@ --- title: Code Editor -excerpt: Edit KCL directly inside Zoo Design Studio. +excerpt: Edit KCL and project text files directly inside Zoo Design Studio. sidebarPosition: 5 --- The Code Editor is the KCL source panel for the active model. +It also opens project text files selected in the +[File Explorer](/docs/zoo-design-studio/features/workspace/file-explorer#open-text-files). ## What You Can Do @@ -12,6 +14,8 @@ The Code Editor is the KCL source panel for the active model. - Format code, copy code, and open KCL docs from the pane menu. - Use diagnostics, lint markers, and syntax-aware editor behavior. - Use undo and redo within the app's editing workflow. +- Edit UTF-8 project text files up to 1 MiB with automatic saving. Markdown files have syntax + highlighting; other non-KCL text files use plain text editing. ## What You Cannot Do diff --git a/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx b/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx index f88fb1d16..d62c34fea 100644 --- a/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx +++ b/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx @@ -22,8 +22,19 @@ The File Explorer shows the files and folders inside the current project. - Archive entries you no longer need. - [Add files from your computer](/docs/zoo-design-studio/features/data-management/import#add-file-to-project) by dragging them into Project Files in the browser or desktop app. - Open `.kcl` files directly for editing. +- Open UTF-8 text files, including JSON, YAML, TOML, source files, and files without an extension. - Reveal the project, or an individual file or folder, in the system file manager on desktop. +## Open Text Files + +Click a text file in Project Files to open it in the Code Editor. Edits save automatically. +Text files can be up to 1 MiB. Binary files and files in other text encodings cannot be edited. +Enable **Show All Files** in user settings to see hidden files and configuration files such as +`project.toml`. + +CAD files keep their import workflow. To edit the text of a CAD file such as STEP or OBJ, +right-click it and choose **Open as Text**. The same encoding and size limits apply. + ## Reveal in the System File Manager Use `Reveal in file explorer` when you need to work with a project in Finder, File Explorer, or your From 71470e0ea388de275b7f92c8f930c693846bdf6d Mon Sep 17 00:00:00 2001 From: Pierre Jacquier Date: Sat, 17 Oct 2026 15:30:03 -0400 Subject: [PATCH 2/2] Document single-click opening for text-based CAD files --- .../zoo-design-studio/features/workspace/file-explorer.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx b/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx index d62c34fea..aed121a1b 100644 --- a/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx +++ b/content/pages/docs/zoo-design-studio/features/workspace/file-explorer.mdx @@ -32,8 +32,8 @@ Text files can be up to 1 MiB. Binary files and files in other text encodings ca Enable **Show All Files** in user settings to see hidden files and configuration files such as `project.toml`. -CAD files keep their import workflow. To edit the text of a CAD file such as STEP or OBJ, -right-click it and choose **Open as Text**. The same encoding and size limits apply. +Text-based CAD files such as STEP or OBJ also open with a click. To import a CAD file into the +model, right-click it and choose **Import in current file**. ## Reveal in the System File Manager