Revising cds2014 samples based on first round of feedback.

native_client_sdk/src/doc/cds2014/python.rst

 .. _cds2014_python:
 
 ########################################
 What a difference Python Makes - Codelab
 ########################################
 
 Introduction
 ------------
 
 .. include:: python_summary.inc
@@ skipping 44 matching lines @@
 Python on the other hand has the |difflib| module in its standard library.
 
 The starting point you've just extracted contains the shell
 of a web app using Portable Native Client Python to generate a diff.
 Just one thing is missing, that whole diffing thing...
 
 To see where things stand, deploy the sample like this::
 
   make
 
-This will copy the sample to /tmp/differ (clobbering whatever is already
-there). It will also attempt to open the sample, but will be blocked by
-a popup blocker. Click on the URL to accept the popup.
+This will attempt to open the sample, but will be blocked by
+a popup blocker the first time. Click on the URL to accept the popup.
+It also clobbers /tmp/differ for good measure.
 
 As you can see, this isn't quite what we're going for.
 
 You'll want to modify diff.py, using the editor you selected earlier.
 You'll probably want to consult the |difflib| documentation.
 I would suggest you check out the HtmlDiff class and make use of
-the make_file member function. I would also suggest the splitlines
+the make_file member function. Note our goal is to create a
+full HTML diff, so the make_table function is insufficient.
+I would also suggest the splitlines
 function may come in handy.
 
 You can test diff.py manually as you would in a normal UNIX environment.
 It can be run like this::
 
   ./diff.py before.txt after.txt out.html
 
 Once everything is working diff.html will contain an html diff.
-Run `make` again to deploy and test the full app.
+After the initial `make` you can hit "Run" to test your changes.
 
 Now get to it, and good luck!
 
 
 What you've learned
 -------------------
 
 While the details of building and packaging Python have been
 insulated from you for the purpose of this exercise, the key take-home lesson
 is how easy it is to leverage Python using PNaCl.
@@ skipping 14 matching lines @@
 `NaCl SDK
 <https://developer.chrome.com/native-client/sdk/download>`_.
 
 For questions, concerns, and help contact us at
 `native-client-discuss@googlegroups.com
 <https://groups.google.com/forum/#!forum/native-client-discuss>`_.
 
 Bring your interpreted app to PNaCl today!
 
 .. include:: ../nacldev/cleanup_web.inc