From 57423c9788c747a56208e6af22ce2afb35acc632 Mon Sep 17 00:00:00 2001 From: Joe Gordon Date: Fri, 1 May 2015 19:21:58 -0700 Subject: [PATCH] Cleanup docs landing page Our docs our wildly out of date and pretty bad, this is a first step at beginning to clean them up and make them more useful. * remove the guidelines section. 2 of them are explicitly wrong (API Compatibility and Open Standards), and no one actually uses these guidelines during development. Yes we want high availability and fault tolerance, but listing these design guidelines here is misleading at best. * Don't explain how this document is built, don't need to explain that so prominently * Update the intro based on Nova's mission statement Change-Id: Ia564a7cacdac0ddab913464ca1c7f9fefb0ee0b5 --- doc/source/index.rst | 22 ++-------------------- 1 file changed, 2 insertions(+), 20 deletions(-) diff --git a/doc/source/index.rst b/doc/source/index.rst index de1f674098d4..6bea7700ed3e 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -18,26 +18,8 @@ Welcome to Nova's developer documentation! ========================================== -Nova is the project name for OpenStack Compute, a cloud computing fabric -controller, the main part of an IaaS system. -Individuals and organizations can use Nova to host and manage their own cloud -computing systems. Nova originated as a project out of NASA Ames Research Laboratory. - -Nova is written with the following design guidelines in mind: - -* **Component based architecture**: Quickly add new behaviors -* **Highly available**: Scale to very serious workloads -* **Fault-Tolerant**: Isolated processes avoid cascading failures -* **Recoverable**: Failures should be easy to diagnose, debug, and rectify -* **Open Standards**: Be a reference implementation for a community-driven api -* **API Compatibility**: Nova strives to provide API-compatible with popular systems like Amazon EC2 - -This documentation is generated by the Sphinx toolkit and lives in the source -tree. Additional draft and project documentation on Nova and other components of OpenStack can -be found on the `OpenStack wiki`_. Cloud administrators, refer to `docs.openstack.org`_. - -.. _`OpenStack wiki`: http://wiki.openstack.org -.. _`docs.openstack.org`: http://docs.openstack.org +Nova is an OpenStack project designed to provide power massively scalable, on +demand, self service access to compute resources. Developer Docs