From d76b04c7270c7e838bff50f375401362efd24bc8 Mon Sep 17 00:00:00 2001
From: Fred Lifton <fred.lifton@docker.com>
Date: Fri, 12 Sep 2014 14:50:11 -0700
Subject: [PATCH] Edits and revision to README-content.md and README-short.txt.

---
 python/README-content.md | 18 +++++++++++++-----
 python/README-short.txt  |  2 +-
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/python/README-content.md b/python/README-content.md
index f6b893f8e557..6e5b5f41adfe 100644
--- a/python/README-content.md
+++ b/python/README-content.md
@@ -1,12 +1,18 @@
 # What is Python?
 
-Python is a widely used general-purpose, high-level programming language. Its design philosophy emphasizes code readability, and its syntax allows programmers to express concepts in fewer lines of code than would be possible in languages such as C. The language provides constructs intended to enable clear programs on both a small and large scale.
+Python is an interpreted, interactive, object-oriented, open-source programming language.
+It incorporates modules, exceptions, dynamic typing, very high level dynamic data types,
+and classes. Python combines remarkable power with very clear syntax. It has interfaces
+to many system calls and libraries, as well as to various window systems, and is
+extensible in C or C++. It is also usable as an extension language for applications that
+need a programmable interface. Finally, Python is portable: it runs on many Unix
+variants, on the Mac, and on Windows 2000 and later.
 
 > [wikipedia.org/wiki/Python_(programming_language)](https://en.wikipedia.org/wiki/Python_(programming_language))
 
 # How to use this image
 
-## Create a `Dockerfile` in your python app project.
+## Create a `Dockerfile` in your Python app project.
 
     FROM python:3
     COPY . /usr/src/myapp
@@ -20,14 +26,16 @@ or (if you need to use Python 2):
     WORKDIR /usr/src/myapp
     CMD [ "python", "./your-daemon-or-script.py" ]
 
-Then build and run the docker image.
+You can then build and run the Docker image.
 
     docker build -t my-python-app
     docker run -it --rm --name my-running-app my-python-app
 
-## Run a single python script.
+## Run a single Python script.
 
-For many single file projects, it may not be convenient to write a `Dockerfile` for your project. In such cases, you can run a python script by using the python docker image directly.
+For many simple, single file projects, you may find it inconvenient to write a complete
+`Dockerfile`. In such cases, you can run a Python script by using the Python Docker image
+directly.
 
     docker run -it --rm --name my-running-script -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp python:3 python your-daemon-or-script.py
 
diff --git a/python/README-short.txt b/python/README-short.txt
index f214d615ba68..52ef45a68264 100644
--- a/python/README-short.txt
+++ b/python/README-short.txt
@@ -1 +1 @@
-Python is a widely used general-purpose, high-level programming language.
+Python is an interpreted, interactive, object-oriented, open-source programming language. It incorporates modules, exceptions, dynamic typing, very high level dynamic data types, and classes.