From 899a664579ad4467b6c44434cd6ef7d048b933c8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Wro=C5=84ski?= <lukaszwronski98@gmail.com>
Date: Mon, 11 Jul 2022 15:07:58 +0200
Subject: [PATCH] Add docs to scripts.md

---
 website/docs/commands/run.md   |  1 +
 website/docs/guides/scripts.md | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/website/docs/commands/run.md b/website/docs/commands/run.md
index 844e0470dd..2aecec767c 100644
--- a/website/docs/commands/run.md
+++ b/website/docs/commands/run.md
@@ -85,6 +85,7 @@ object Utils {
 
 ```bash
 scala-cli Main.scala
+# Hello World
 ```
 
 <!-- Expected:
diff --git a/website/docs/guides/scripts.md b/website/docs/guides/scripts.md
index 47a25541f3..04579e2722 100644
--- a/website/docs/guides/scripts.md
+++ b/website/docs/guides/scripts.md
@@ -163,6 +163,32 @@ world
 
 </ChainedSnippets>
 
+### Define source files in using directives
+
+You can also add source files with the using directive `//> using file` in Scala Scripts:
+
+```scala title=main.sc
+//> using file "Utils.scala" 
+
+println(Utils.message)
+```
+```scala title=Utils.scala
+object Utils {
+  val message = "Hello World"
+}
+```
+
+`scala-cli` compiles and adds to the class path source `Utils.scala`.
+
+```bash
+scala-cli main.sc
+# Hello World
+```
+
+<!-- Expected:
+Hello World
+-->
+
 ### Difference with Ammonite scripts
 
 [Ammonite](http://ammonite.io) is a popular REPL for Scala that can also compile and run `.sc` files.