diff options
author | Ian Lewis <ianlewis@google.com> | 2018-11-29 04:48:15 -0800 |
---|---|---|
committer | Shentubot <shentubot@google.com> | 2018-11-29 04:49:20 -0800 |
commit | db0473b1bec1481e5a7807752b5eaa72c816c562 (patch) | |
tree | fc0f2f05b36507c783a6300bc30bba33e965e91d /docs/README.md | |
parent | 4d0da37cbb81292c66a8d7a7b8d5658450a847f5 (diff) |
Add a new docs directory. refs #109
Add a new 'docs' directory for that can be built on in the future. Docs are
divided into a 'user guide', 'contributor guide', and 'architecture guide'.
This is currently a work in progress.
PiperOrigin-RevId: 223326836
Change-Id: I78d08d6a89d686e92d3415d4269463e8e74bddee
Diffstat (limited to 'docs/README.md')
-rw-r--r-- | docs/README.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 000000000..6f847fa4b --- /dev/null +++ b/docs/README.md @@ -0,0 +1,37 @@ +# gVisor Documentation + +**This doc is a work in progress. For the definitive documentation please see +the [README](../README.md)** + +gVisor is a user-space kernel, written in Go, that implements a substantial +portion of the [Linux system call interface][linux-interface]. It provides an +additional layer of isolation between running applications and the host +operating system. + +gVisor includes an [Open Container Initiative (OCI)][oci] runtime called `runsc` +that makes it easy to work with existing container tooling. The `runsc` runtime +integrates with Docker and Kubernetes, making it simple to run sandboxed +containers. + +Check out the [gVisor Quick Start](user_guide/quick_start.md) to get started +using gVisor. + +gVisor takes a distinct approach to container sandboxing and makes a different +set of technical trade-offs compared to existing sandbox technologies, thus +providing new tools and ideas for the container security landscape. + +Check out [Why gVisor?](architecture_guide/why.md) for more on why we made +gVisor. + +## How this documentation is organized + +- The [Architecture Guide](architecture_guide/README.md) explains about + gVisor's architecture & design philosophy. Start here if you would like to + know more about how gVisor works and why it was created. +- The [User Guide](user_guide/README.md) contains info on how to use gVisor + and integrate it into your application or platform. +- The [Contributer Guide](contributer_guide/README.md) includes documentation + on how to build gVisor, run tests, and contribute to gVisor's development. + +[linux-interface]: https://en.wikipedia.org/wiki/Linux_kernel_interfaces +[oci]: https://www.opencontainers.org |