@@ -1,20 +1,56 @@

 ![Photon](http://storage.googleapis.com/project-photon/vmw-logo-photon.svg "VMware Photon")

-**Welcome to VMware Photon OS: Linux Container Host**

+# Photon OS: Linux Container Host

-This repository is intended for developers who want to modify Photon and build their own customized ISO images or contribute to the code base.

+### Contents

+- [What is Photon OS](#what-is-photon)

+- [Getting Photon OS](#getting-photon)

+- [Getting Started](#getting-started)

+- [Contributing](#contributing)

+- [License](#license)

+- [Photon OS Resources](#resources)

-**Photon OS 2.0 is here!**

+## What is Photon OS?

+Photon OS™ is an open source Linux container host optimized for cloud-native applications, cloud platforms, and VMware infrastructure. Photon OS provides a secure run-time environment for efficiently running containers. Some of the key highlights of Photon OS are:

+

+* Optimized for VMware hypervisor: The Linux kernel is tuned for performance when Photon OS runs on VMware ESXi.

+

+* Support for containers: Photon OS includes the Docker daemon and works with container orchestration frameworks, such as Mesos and Kubernetes.

+

+* Efficient lifecycle management: Photon OS is easy to manage, patch, and update.

+

+* Security hardened: Photon OS provides secure and up-to-date kernel and other packages, and its policies are designed to govern the system securely.

+

+For an overview of Photon OS, see [https://vmware.github.io/photon/](https://vmware.github.io/photon/)

+

+## Getting Photon OS

+

+Photon OS binaries are available in a number of formats, including ISO, OVA and cloud images such as Amazon AMI, Google Cloud GCE image and Azure VHD.

+

+For download instructions and links to Photon OS binaries, go to the [Download Guide in the github wiki](https://github.com/vmware/photon/wiki/Downloading-Photon-OS).

+

+*Photon OS 2.0 is here!*

 --------------------------

 Photon OS 2.0 introduces new security and OS management capabilities, along with new and updated packages for Cloud native applications and VMware appliances. 

-- For download instructions and links to Photon OS binaries, go to the [Download Guide in the github wiki](https://github.com/vmware/photon/wiki/Downloading-Photon-OS).

-- For an overview of changes, see [What's New in Photon OS 2.0 in the github wiki](https://github.com/vmware/photon/wiki/What-is-New-in-Photon-OS-2.0).

+For an overview of changes, see [What's New in Photon OS 2.0 in the github wiki](https://github.com/vmware/photon/wiki/What-is-New-in-Photon-OS-2.0).

+

+## Getting Started

+Begin your Photon OS journey by browsing our extensive guides on getting started in the [Photon OS GitHub Wiki](https://github.com/vmware/photon/wiki).

+

+## Contributing

+The Photon OS project team welcomes contributions from the community.

+

+If you wish to contribute code and you have not signed our Contributor License Agreement (CLA), our CLA-bot will take you through the process and update the issue when you open a [Pull Request](https://help.github.com/articles/creating-a-pull-request). If you have questions about the CLA process, see our CLA [FAQ](https://cla.vmware.com/faq) or contact us through the GitHub issue tracker.

+

+To help you get started making contributions to Photon OS, we have collected some helpful best practices in the [Contributing guidelines](https://github.com/vmware/photon/blob/master/contributing.md).

+

+## License

+The Photon OS ISO and OVA images are distributed under the [Photon OS EULA](https://github.com/vmware/photon/blob/2.0/installer/EULA.txt).

+

+With the exception of the 'libtdnf' source code, Photon OS source code is distributed under GNU GPL v2. The 'libtdnf' source code is distributed under GNU LGPL v2.1. For more details, please refer to the [Photon OS Open Source License file](https://github.com/vmware/photon/blob/master/COPYING).

-**Photon OS Resources**

+## Photon OS Resources

 - **Documentation**: See the [Docs](docs/) folder.

 - **Security Updates**: Visit [Security-Advisories](https://github.com/vmware/photon/wiki/Security-Advisories).