docs: small documentation fixes

Steve Canny · Steve Canny · commit 671768690260 · 2016-04-22T19:55:47.000-07:00
diff --git a/docs/user/documents.rst b/docs/user/documents.rst
@@ -1,3 +1,4 @@
+.. _documents:
 
 Working with Documents
 ==========================
@@ -70,20 +71,24 @@ to (or aren't allowed to) interact with the file system. In practice this means
 you can pass an open file or StringIO/BytesIO stream object to open or save
 a document like so::
 
-    f = open('foobar.docx')
+    f = open('foobar.docx', 'rb')
     document = Document(f)
     f.close()
 
     # or
 
-    with open('foobar.docx') as f:
+    with open('foobar.docx', 'rb') as f:
         source_stream = StringIO(f.read())
     document = Document(source_stream)
     source_stream.close()
     ...
     target_stream = StringIO()
     document.save(target_stream)
 
+The ``'rb'`` file open mode parameter isn't required on all operating
+systems. It defaults to ``'r'`` which is enough sometimes, but the 'b'
+(selecting binary mode) is required on Windows and at least some versions of
+Linux to allow Zipfile to open the file.
 
 Okay, so you've got a document open and are pretty sure you can save it
 somewhere later. Next step is to get some content in there ...
diff --git a/docs/user/sections.rst b/docs/user/sections.rst
@@ -52,7 +52,7 @@ The :meth:`Document.add_section` method allows a new section to be started at
 the end of the document. Paragraphs and tables added after calling this method
 will appear in the new section::
 
-    >>> current_section = document.section[-1]  # last section in document
+    >>> current_section = document.sections[-1]  # last section in document
     >>> current_section.start_type
     NEW_PAGE (2)
     >>> new_section = document.add_section(WD_SECTION.ODD_PAGE)
