diff --git a/doc/common/section_cli_overview.xml b/doc/common/section_cli_overview.xml index 5700cdd944..1b415d5477 100644 --- a/doc/common/section_cli_overview.xml +++ b/doc/common/section_cli_overview.xml @@ -5,23 +5,30 @@ version="5.0" xml:id="section_cli_overview"> Overview - You can use the OpenStack command-line clients to run simple commands - that make API calls. You can run these commands from the command line or - in scripts to automate tasks. If you provide OpenStack credentials, you - can run these commands on any computer. - Internally, each client command runs cURL commands that - embed API requests. The OpenStack APIs are RESTful APIs that - use the HTTP protocol, including methods, URIs, media types, - and response codes. - These open-source Python clients run on Linux or Mac OS X - systems and are easy to learn and use. Each OpenStack service - has its own command-line client. On some client commands, you - can specify a debug - parameter to show the underlying API request for the command. - This is a good way to become familiar with the OpenStack API - calls. - The following table lists the command-line client for each OpenStack - service with its package name and description. + + Each OpenStack project provides a command-line client, which + enables you to access the project API through easy-to-use + commands. For example, the Compute service provides a nova + command-line client. + + You can run the commands from the command line, or include the + commands within scripts to automate tasks. If you provide + OpenStack credentials, such as your user name and password, you + can run these commands on any computer. + + + Internally, each command uses cURL command-line tools, which embed + API requests. OpenStack APIs are RESTful APIs, and use the HTTP + protocol. They include methods, URIs, media types, and response + codes. + + OpenStack APIs are open-source Python clients, and can run on + Linux or Mac OS X systems. On some client commands, you can + specify a debug parameter to show the + underlying API request for the command. This is a good way to + become familiar with the OpenStack API calls. + The following table lists the command-line client for each + OpenStack service with its package name and description.
OpenStack services and clients