diff options
author | Andy Jiang <andyjiang@gmail.com> | 2023-04-16 16:08:05 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-04-17 01:08:05 +0200 |
commit | 26aafd3a15bf186977b3ac80356b380d422d86e2 (patch) | |
tree | 179df32393dcfd3febf19e5dab18668dd8290d43 /README.md | |
parent | 94744ae25a15723ee17d7ed975f3d69bc5441f88 (diff) |
docs(readme): Update readme (#18677)
- updated examples
- added more resources
- added youtube
---------
Co-authored-by: Bartek IwaĆczuk <biwanczuk@gmail.com>
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 73 |
1 files changed, 43 insertions, 30 deletions
@@ -1,22 +1,29 @@ # Deno -[![Build Status - Cirrus][]][Build status] [![Twitter handle][]][Twitter badge] -[](https://discord.gg/deno) +[](https://crates.io/crates/deno) +[![Twitter badge][]][Twitter link] [![Discord badge][]][Discord link] +[![YouTube badge][]][Youtube link] <img align="right" src="https://deno.land/logo.svg" height="150px" alt="the deno mascot dinosaur standing in the rain"> -Deno is a _simple_, _modern_ and _secure_ runtime for **JavaScript** and -**TypeScript** that uses V8 and is built in Rust. +[Deno](https://deno.com/runtime) is a _simple_, _modern_ and _secure_ runtime +for **JavaScript** and **TypeScript** that uses V8 and is built in Rust. ### Features -- Secure by default. No file, network, or environment access, unless explicitly - enabled. -- Supports TypeScript out of the box. +- [Secure by default.](https://deno.land/manual/basics/permissions) No file, + network, or environment access, unless explicitly enabled. +- Provides + [web platform functionality and APIs](https://deno.land/manual/runtime/web_platform_apis), + e.g. using ES modules, web workers, and `fetch()`. +- Supports + [TypeScript out of the box](https://deno.land/manual/advanced/typescript). - Ships only a single executable file. -- [Built-in utilities.](https://deno.land/manual/tools#built-in-tooling) -- Set of reviewed standard modules that are guaranteed to work with - [Deno](https://deno.land/std/). +- [Built-in tooling](https://deno.land/manual/tools#built-in-tooling) including + `deno test`, `deno fmt`, `deno bench`, and more. +- Includes [a set of reviewed standard modules](https://deno.land/std/) + guaranteed to work with Deno. +- [Supports npm.](https://deno.land/manual/node) ### Install @@ -62,34 +69,36 @@ and [releases](https://github.com/denoland/deno/releases) for other options. ### Getting Started -Try running a simple program: +Try [running a simple program](https://examples.deno.land/hello-world): ```sh deno run https://deno.land/std/examples/welcome.ts ``` -Or a more complex one: +Or [setup a simple HTTP server](https://examples.deno.land/http-server): ```ts -const listener = Deno.listen({ port: 8000 }); -console.log("http://localhost:8000/"); - -for await (const conn of listener) { - serve(conn); -} - -async function serve(conn: Deno.Conn) { - for await (const { respondWith } of Deno.serveHttp(conn)) { - respondWith(new Response("Hello world")); - } -} +import { serve } from "https://deno.land/std@0.182.0/http/server.ts"; + +serve((_req) => new Response("Hello, World!")); ``` -You can find a deeper introduction, examples, and environment setup guides in -the [manual](https://deno.land/manual). +[More examples](https://examples.deno.land/). + +### Additional Resources -The complete API reference is available at the runtime -[documentation](https://doc.deno.land). +- **[The Deno Manual](https://deno.land/manual)** is a great starting point for + [additional examples](https://deno.land/manual/examples), + [setting up your environment](https://deno.land/manual/getting_started/setup_your_environment), + [using npm](https://deno.land/manual/node), and more. +- **[Runtime API reference](https://deno.land/api)** documents all APIs built + into Deno CLI. +- **[Deno Standard Modules](https://deno.land/std)** do not have external + dependencies and are reviewed by the Deno core team. +- **[deno.land/x](https://deno.land/x)** is the registry for third party + modules. +- **[Blog](https://deno.com/blog)** is where the Deno team shares important + product updates and "how to"s, about solving technical problems. ### Contributing @@ -100,5 +109,9 @@ To contribute, please read our [Build Status - Cirrus]: https://github.com/denoland/deno/workflows/ci/badge.svg?branch=main&event=push [Build status]: https://github.com/denoland/deno/actions -[Twitter badge]: https://twitter.com/intent/follow?screen_name=deno_land -[Twitter handle]: https://img.shields.io/twitter/follow/deno_land.svg?style=social&label=Follow +[Twitter badge]: https://img.shields.io/twitter/follow/deno_land.svg?style=social&label=Follow +[Twitter link]: https://twitter.com/intent/follow?screen_name=deno_land +[YouTube badge]: https://img.shields.io/youtube/channel/subscribers/UCqC2G2M-rg4fzg1esKFLFIw?style=social +[YouTube link]: https://www.youtube.com/@deno_land +[Discord badge]: https://img.shields.io/discord/684898665143206084?logo=discord&style=social +[Discord link]: https://discord.gg/deno |