Merge "Update readme file"

README.rst

@@ -1,30 +1,29 @@
+======
 Ironic
 ======
 
-Ironic is an integrated OpenStack project which aims to provision bare
+Ironic consists of an API and plug-ins for managing and provisioning
-metal machines instead of virtual machines, forked from the Nova Baremetal
+physical machines in a security-aware and fault-tolerant manner. It can be
-driver. It is best thought of as a bare metal hypervisor **API** and a set
+used with nova as a hypervisor driver, or standalone service using bifrost.
-of plugins which interact with the bare metal hypervisors. By default, it
+By default, it will use PXE and IPMI to interact with bare metal machines.
-will use PXE and IPMI together to provision and turn on/off machines,
+Ironic also supports vendor-specific plug-ins which may implement additional
-but Ironic also supports vendor-specific plugins which may implement
+functionality.
-additional functionality.
 
------------------
+Ironic is distributed under the terms of the Apache License, Version 2.0. The
-Project Resources
+full terms and conditions of this license are detailed in the LICENSE file.
------------------
+
+Project resources
+~~~~~~~~~~~~~~~~~
 
-* Free software: Apache license
 * Documentation: http://docs.openstack.org/developer/ironic
 * Source: http://git.openstack.org/cgit/openstack/ironic
 * Bugs: http://bugs.launchpad.net/ironic
 * Wiki: https://wiki.openstack.org/wiki/Ironic
+* APIs: http://developer.openstack.org/api-ref/baremetal/index.html
 
-Project status, bugs and RFEs (requests for feature enhancements)
+Project status, bugs, and requests for feature enhancements (RFEs) are tracked
-are tracked on Launchpad:
+on Launchpad:
+http://launchpad.net/ironic
 
-  http://launchpad.net/ironic
+For information on how to contribute to ironic, see
-
+http://docs.openstack.org/infra/manual/developers.html
-Anyone wishing to contribute to an OpenStack project should
-find a good reference here:
-
-  http://docs.openstack.org/infra/manual/developers.html