foster/denoland-deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-28 16:20:57 -05:00
Code Issues Packages 1 Wiki Activity

docs(introduction): Improve wording and capitalization (#8848)

Browse source
This commit is contained in:
Waldir Pimenta 2020-12-28 23:05:29 +00:00 committed by GitHub
parent 6719cb9b2a
commit b778f8bbff
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 14 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
cli/dts/lib.deno.unstable.d.ts vendored
View file

@ -319,7 +319,7 @@ declare namespace Deno {
* [tslib](https://www.npmjs.com/package/tslib). */ * [tslib](https://www.npmjs.com/package/tslib). */
importHelpers?: boolean; importHelpers?: boolean;
/** This flag controls how `import` works, there are 3 different options: /** This flag controls how `import` works, there are 3 different options:
* *
* - `remove`: The default behavior of dropping import statements which only * - `remove`: The default behavior of dropping import statements which only
* reference types. * reference types.
* - `preserve`: Preserves all `import` statements whose values or types are * - `preserve`: Preserves all `import` statements whose values or types are
@ -328,7 +328,7 @@ declare namespace Deno {
* but will error when a value import is only used as a type. This might * but will error when a value import is only used as a type. This might
* be useful if you want to ensure no values are being accidentally * be useful if you want to ensure no values are being accidentally
* imported, but still make side-effect imports explicit. * imported, but still make side-effect imports explicit.
* *
* This flag works because you can use `import type` to explicitly create an * This flag works because you can use `import type` to explicitly create an
* `import` statement which should never be emitted into JavaScript. */ * `import` statement which should never be emitted into JavaScript. */
importsNotUsedAsValues?: "remove" | "preserve" | "error"; importsNotUsedAsValues?: "remove" | "preserve" | "error";
@ -1041,7 +1041,7 @@ declare namespace Deno {
* identified by `pid`. * identified by `pid`.
* *
* const p = Deno.run({ * const p = Deno.run({
* cmd: ["python", "-c", "from time import sleep; sleep(10000)"] * cmd: ["sleep", "10000"]
* }); * });
* *
* Deno.kill(p.pid, Deno.Signal.SIGINT); * Deno.kill(p.pid, Deno.Signal.SIGINT);

21
docs/introduction.md
View file

@ -5,7 +5,7 @@ developer experience.
It's built on V8, Rust, and Tokio. It's built on V8, Rust, and Tokio.
## Feature Highlights ## Feature highlights
- Secure by default. No file, network, or environment access (unless explicitly - Secure by default. No file, network, or environment access (unless explicitly
enabled). enabled).
@ -31,21 +31,22 @@ Deno explicitly takes on the role of both runtime and package manager. It uses a
standard browser-compatible protocol for loading modules: URLs. standard browser-compatible protocol for loading modules: URLs.
Among other things, Deno is a great replacement for utility scripts that may Among other things, Deno is a great replacement for utility scripts that may
have been historically written with bash or python. have been historically written with Bash or Python.
## Goals ## Goals
- Only ship a single executable (`deno`). - Only ship a single executable (`deno`).
- Provide Secure Defaults. - Provide secure defaults.
- Unless specifically allowed, scripts can't access files, the environment, or - Unless specifically allowed, scripts can't access files, the environment, or
the network. the network.
- Browser compatible: The subset of Deno programs which are written completely - Be browser-compatible.
in JavaScript and do not use the global `Deno` namespace (or feature test for - The subset of Deno programs which are written completely in JavaScript and
it), ought to also be able to be run in a modern web browser without change. do not use the global `Deno` namespace (or feature test for it), ought to
- Provide built-in tooling like unit testing, code formatting, and linting to also be able to be run in a modern web browser without change.
improve developer experience. - Provide built-in tooling to improve developer experience.
- Does not leak V8 concepts into user land. - E.g. unit testing, code formatting, and linting.
- Be able to serve HTTP efficiently. - Not leak V8 concepts into user land.
- Serve HTTP efficiently.
## Comparison to Node.js ## Comparison to Node.js