From 473d7317eafad44de4d99a3b0aa54f7e1d49ed79 Mon Sep 17 00:00:00 2001 From: Ryan Dahl Date: Tue, 12 Feb 2019 23:54:08 -0500 Subject: More web design work (#1759) --- website/benchmarks.html | 1 + website/manual.html | 1 + website/manual.md | 34 ++++++++++++++++------------------ website/style_guide.html | 1 + 4 files changed, 19 insertions(+), 18 deletions(-) diff --git a/website/benchmarks.html b/website/benchmarks.html index 0c270d2be..016d2ff5f 100644 --- a/website/benchmarks.html +++ b/website/benchmarks.html @@ -9,6 +9,7 @@
+

Deno Continuous Benchmarks

diff --git a/website/manual.html b/website/manual.html index 1301b6895..cbdbd79e1 100644 --- a/website/manual.html +++ b/website/manual.html @@ -8,6 +8,7 @@

+
diff --git a/website/manual.md b/website/manual.md index dbc2f9114..5ec0ccdb1 100644 --- a/website/manual.md +++ b/website/manual.md @@ -6,20 +6,19 @@ A word of caution: Deno is very much under development. We encourage brave early adopters, but expect bugs large and small. The API is subject to change without -notice. - -[Bug reports](https://github.com/denoland/deno/issues) do help! +notice. [Bug reports](https://github.com/denoland/deno/issues) do help! ## Introduction ### Philosophy -Deno aims to be a useful multitool tool for the modern programmer. +Deno aims to be a productive and secure scripting environment for the modern +programmer. It will always be distributed as a single executable - and that executable will be sufficient software to run any deno program. Given a URL to a deno program, -you should be able to execute it with nothing more than the 50M deno executable. +you should be able to execute it with nothing more than the 50 megabyte deno +executable. Deno explicitly takes on the role of both runtime and package manager. It uses a standard browser-compatible protocol for loading modules: URLs. @@ -30,17 +29,10 @@ the default being the most restrictive secure sandbox. Deno provides a set of reviewed (audited) standard modules that are guaranteed to work with Deno. -Deno is opinionated and defines style guides and has -automated -formatters. - -### Design goals +### Goals - Support TypeScript out of the box. -- No `package.json`. No npm. Not explicitly compatible with Node. - - Like the browser, allows imports from URLs: ```typescript @@ -64,13 +56,19 @@ formatters. - Always dies on uncaught errors. +- Browser compatible: The subset of Deno programs which are written completely + in JavaScript and do not use the global `Deno` namespace (or feature test for + it), ought to also be able to be run in a modern web browser without change. + - [Aims to support top-level `await`.](https://github.com/denoland/deno/issues/471) -### Browser compatibility +### Non-goals + +- No `package.json`. + +- No npm. -The subset of Deno programs which are written completely in JavaScript and do -not use the global `Deno` namespace (or feature test for it), ought to also be -able to be run in a modern web browser without change. +- Not explicitly compatible with Node. ## Setup diff --git a/website/style_guide.html b/website/style_guide.html index 4acf13649..ec6012b23 100644 --- a/website/style_guide.html +++ b/website/style_guide.html @@ -8,6 +8,7 @@
+
-- cgit v1.2.3