more doc strings

Author: ggrammar

docs/Makefile

@@ -5,8 +5,8 @@
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = pizzapi
-SOURCEDIR     = .
-BUILDDIR      = _build
+SOURCEDIR     = source
+BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".
 help:

pizzapi/address.py

@@ -3,12 +3,19 @@
 from .urls import Urls, COUNTRY_USA
 
 class Address(object):
-    """
-    Create an address, for finding stores and placing orders.
+    """Create an address, for finding stores and placing orders.
 
     The Address object describes a street address in North America (USA or
     Canada, for now). Callers can use the Address object's methods to find
     the closest or nearby stores from the API. 
+
+    Attributes:
+        street (String): Street address
+        city (String): North American city
+        region (String): North American region (state, province, territory)
+        zip (String): North American ZIP code
+        urls (String): Country-specific URLs
+        country (String): Country
     """
 
     def __init__(self, street, city, region='', zip='', country=COUNTRY_USA, *args):
@@ -33,8 +40,7 @@ def line2(self):
         return '{City}, {Region}, {PostalCode}'.format(**self.data)
 
     def nearby_stores(self, service='Delivery'):
-        """
-        Query the API to find nearby stores.
+        """Query the API to find nearby stores.
 
         nearby_stores will filter the information we receive from the API
         to exclude stores that are not currently online (!['IsOnlineNow']),