index : static-web-server.git

ascending towards madness

author dabrd <52382920+dabrd@users.noreply.github.com> 2023-04-18 19:14:36.0 +00:00:00
committer GitHub <noreply@github.com> 2023-04-18 19:14:36.0 +00:00:00
commit
29b35876858ed261e3fd967d0d536e210bbabdf4 [patch]
tree
363bc57ebafa94bade7b80185b151f441a9e973e
parent
32398b42d60fb17950a519b626a249ed438950ef
download
29b35876858ed261e3fd967d0d536e210bbabdf4.tar.gz

docs: minor README grammatical & readability updates (#196) [skip ci]



Diff

 README.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 51a52a0..3690656 100644
--- a/README.md
+++ b/README.md
@@ -26,21 +26,21 @@

## Overview

**Static Web Server** (or **`SWS`** abbreviated) is a very small and fast production-ready web server suitable to serve static web files or assets.
**Static Web Server** (or **`SWS`** abbreviated) is a tiny and fast production-ready web server suitable to serve static web files or assets.

It is focused on **lightness and easy-to-use** principles while keeping [high performance and safety]https://blog.rust-lang.org/2015/04/10/Fearless-Concurrency.html powered by [The Rust Programming Language]https://rust-lang.org.

Written on top of [Hyper]https://github.com/hyperium/hyper and [Tokio]https://github.com/tokio-rs/tokio runtime. It provides [concurrent and asynchronous networking abilities]https://rust-lang.github.io/async-book/01_getting_started/02_why_async.html as well as the latest HTTP/1 - HTTP/2 implementations.
Written on top of [Hyper]https://github.com/hyperium/hyper and [Tokio]https://github.com/tokio-rs/tokio runtime, it provides [concurrent and asynchronous networking abilities]https://rust-lang.github.io/async-book/01_getting_started/02_why_async.html and the latest HTTP/1 - HTTP/2 implementations.

It's cross-platform and available for `Linux`, `macOS`, `Windows` and `FreeBSD` (`x86`/`x86_64`,  `ARM`/`ARM64`) as well as `Docker`.
It's cross-platform and available for `Linux`, `macOS`, `Windows` and `FreeBSD` (`x86`/`x86_64`,  `ARM`/`ARM64`) and `Docker`.

![static-web-server]https://user-images.githubusercontent.com/1700322/152613820-658f025c-d0a4-46b3-aa6d-bdc7f638ce77.png

## Features

- Built with [Rust]https://rust-lang.org which is focused on [safety, speed and concurrency]https://kornel.ski/rust-c-speed.
- Memory safe and very reduced CPU and RAM overhead.
- Blazing fast static files-serving and asynchronous powered by latest [Hyper]https://github.com/hyperium/hyper/, [Tokio]https://github.com/tokio-rs/tokio and a set of [awesome crates]https://github.com/static-web-server/static-web-server/blob/master/Cargo.toml.
- Built with [Rust]https://rust-lang.org, which focuses on [safety, speed and concurrency]https://kornel.ski/rust-c-speed.
- Memory-safe and significantly reduced CPU and RAM overhead.
- Blazing fast static files-serving and asynchronous powered by the latest [Hyper]https://github.com/hyperium/hyper/, [Tokio]https://github.com/tokio-rs/tokio and a set of [awesome crates]https://github.com/static-web-server/static-web-server/blob/master/Cargo.toml.
- Single __4MB__ (uncompressed) and fully static binary with no dependencies ([Musl libc]https://doc.rust-lang.org/edition-guide/rust-2018/platform-and-target-support/musl-support-for-fully-static-binaries.html). Suitable for running on [any Linux distro]https://en.wikipedia.org/wiki/Linux_distribution or [Docker container]https://hub.docker.com/r/joseluisq/static-web-server/tags.
- Optional GZip, Deflate or Brotli compression for text-based web files only.
- Compression on-demand via [Accept-Encoding]https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding header.
@@ -51,7 +51,7 @@ It's cross-platform and available for `Linux`, `macOS`, `Windows` and `FreeBSD` 
- [Security headers]https://web.dev/security-headers/ for HTTP/2 by default.
- [HEAD]https://tools.ietf.org/html/rfc7231#section-4.3.2 responses.
- Lightweight and configurable logging via [tracing]https://github.com/tokio-rs/tracing crate.
- Customizable number of worker threads.
- A Customizable number of worker threads.
- Optional directory listing.
- [CORS]https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS support.
- Basic HTTP Authentication.
@@ -63,12 +63,12 @@ It's cross-platform and available for `Linux`, `macOS`, `Windows` and `FreeBSD` 
- Custom URL rewrites and redirects via glob patterns.
- Support for serving pre-compressed (Gzip/Brotli) files.
- First-class [Docker]https://docs.docker.com/get-started/overview/ support. [Scratch]https://hub.docker.com/_/scratch and latest [Alpine Linux]https://hub.docker.com/_/alpine Docker images.
- Ability to accept a socket listener as a file descriptor for use in sandboxing and on-demand applications (E.g [systemd]http://0pointer.de/blog/projects/socket-activation.html).
- Ability to accept a socket listener as a file descriptor for sandboxing and on-demand applications (e.g [systemd]http://0pointer.de/blog/projects/socket-activation.html).
- Cross-platform. Pre-compiled binaries for Linux, macOS, Windows and FreeBSD (`x86`,`x86_64`,`ARM`,`ARM64`).

## Documentation

For more details about the API, usage and examples please have a look at [The Documentation Website]https://static-web-server.net/.
Please refer to [The Documentation Website]https://static-web-server.net/ for more details about the API, usage and examples.

## Releases

@@ -85,13 +85,13 @@ See more details on [benchmark/BENCHMARKS.md](benchmark/BENCHMARKS.md)
## Notes

- If you're looking for `v1` please go to [1.x]https://github.com/static-web-server/static-web-server/tree/1.x branch.
- If you want to migrate from `v1` to `v2` please take a look at [Migrating from `v1` to `v2`]https://static-web-server.net/migration/ release.
- If you want to migrate from `v1` to `v2` please view [Migrating from `v1` to `v2`]https://static-web-server.net/migration/ release.

## Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in current work by you, as defined in the Apache-2.0 license, shall be dual licensed as described below, without any additional terms or conditions.
Unless you explicitly state otherwise, any contribution you intentionally submitted for inclusion in current work, as defined in the Apache-2.0 license, shall be dual licensed as described below, without any additional terms or conditions.

Feel free to send some [Pull request]https://github.com/static-web-server/static-web-server/pulls or file an [issue]https://github.com/static-web-server/static-web-server/issues.
Feel free to submit a [pull request]https://github.com/static-web-server/static-web-server/pulls or file an [issue]https://github.com/static-web-server/static-web-server/issues.

## License