Some doc tweaks

karimbahgat · karimbahgat · commit 893cab9afec4 · 2018-09-01T23:17:16.000-04:00
diff --git a/README.md b/README.md
@@ -12,7 +12,7 @@ The Python Shapefile Library (pyshp) reads and writes ESRI Shapefiles in pure Py
 
 [Version Changes](#version-changes)
 
-[Basic Use](#basic-use)
+[Examples](#examples)
 - [Reading Shapefiles](#reading-shapefiles)
   - [Reading Shapefiles Using the Context Manager](#reading-shapefiles-using-the-context-manager)
   - [Reading Shapefiles from File-Like Objects](#reading-shapefiles-from-file-like-objects)
@@ -28,7 +28,7 @@ The Python Shapefile Library (pyshp) reads and writes ESRI Shapefiles in pure Py
   - [Adding Geometry](#adding-geometry)
   - [Geometry and Record Balancing](#geometry-and-record-balancing)
   
-[More](#more)
+[How To's](#how-tos)
 - [3D and Other Geometry Types](#3d-and-other-geometry-types)
 - [Working with Large Shapefiles](#working-with-large-shapefiles)
 - [Unicode and Shapefile Encodings](#unicode-and-shapefile-encodings)
@@ -76,12 +76,14 @@ part of your geospatial project.
 
 ## 2.0.0
 
-The newest version of PyShp, version 2.x introduced some major new features. 
-This resulted in some API changes that are incompatible with previous versions. 
+The newest version of PyShp, version 2.0 introduced some major new improvements. 
+A great thanks to all who have contributed code and raised issues, and for everyone's
+patience and understanding during the transition period. 
+Some of the new changes are incompatible with previous versions. 
 Users of the previous version 1.x should therefore take note of the following changes
 (Note: Some contributor attributions may be missing): 
 
-Major Changes:
+### Major Changes:
 
 - Full support for unicode text, with custom encoding, and exception handling. 
   - Means that the Reader returns unicode, and the Writer accepts unicode. 
@@ -99,7 +101,7 @@ Major Changes:
 - Add more support and documentation for MultiPatch 3D shapes. 
 - Better documentation of previously unclear aspects, such as field types. 
 
-Important Fixes:
+### Important Fixes:
 
 - More reliable/robust:
   - Fixed shapefile bbox error for empty or point type shapefiles. [@mcuprjak]
@@ -110,11 +112,8 @@ Important Fixes:
 - Bug fixes for reading from case sensitive file names, individual files separately, and from file-like objects. [@gastoneb, @kb003308, @erickskb]
 - Enforce maximum field limit. [@mwtoews]
 
-A great thanks to all who have contributed code and raised issues for version 2.x, and for the patience and understanding during the
-transition period. 
 
-
-# Basic Use
+# Examples
 
 Before doing anything you must import the library.
 
@@ -863,7 +862,7 @@ most shapefile software.
 	
 
 
-# More
+# How To's
 
 ## 3D and Other Geometry Types
 
diff --git a/shapefile.py b/shapefile.py
@@ -2,8 +2,8 @@
 shapefile.py
 Provides read and write support for ESRI Shapefiles.
 author: jlawhead<at>geospatialpython.com
-date: 2017/04/29
-version: 2.0.0-dev
+date: 2018/09/01
+version: 2.0.0
 Compatible with Python versions 2.7-3.x
 """
 
