.. Windows Subsystem for Linux Guide documentation master file, created by
   sphinx-quickstart on Sat Apr 29 13:21:39 2017.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

The Windows Subsystem for Linux Guide!
======================================

Greetings, Earthling! Welcome to The Hitchhiker’s Guide to the Windows Subsystem for Linux (WSL).

**This is a living, breathing guide**. If you’d like to contribute, `fork us on GitHub <https://github.com/kennethreitz/wsl-guide>`_!

This guide is also available in `Chinese <http://wsl-guide-cn.readthedocs.io/>`_.

This handcrafted guide exists to provide both novice and expert Windows and Linux developers a best practice handbook to the installation, configuration, and usage of WSL (Bash on Ubuntu on Windows) on a daily basis.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   background
   installation
   update
   gotchas
   gui
   packages

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`