docs(tools): add documentation for deno compile cmd (#8615)

1 files changed, 18 insertions, 0 deletions

diff --git a/docs/tools/compiler.md b/docs/tools/compiler.md
new file mode 100644
index 000000000..34dbbdcc8
--- /dev/null
+++ b/docs/tools/compiler.md
@@ -0,0 +1,18 @@
+## Compiling Executables
+
+> Since the compile functionality is relatively new, the `--unstable` flag has
+> to be set in order for the command to work.
+
+`deno compile [SRC] [OUT]` will compile the script into a self contained
+executable.
+
+```
+> deno compile --unstable https://deno.land/std/http/file_server.ts
+```
+
+If you omit the `OUT` parameter, the name of the executable file will be
+inferred.
+
+### Cross Compilation
+
+Cross compiling binaries for different platforms is not currently possible.