[Documentation Issue] errors in DNS API example usage

[dupuy]

Page Name: dns-usage
Release: 0.16.0

As noted at https://groups.google.com/d/msg/cloud-dns-discuss/m5CHw1ncS14/lTKvD7O_BgAJ

this example of the DNS API doesn't actually work:

>>> import time
>>> from gcloud import dns
>>> client = dns.Client(project='PROJECT_ID')
>>> zone = client.zone('acme-co', 'example.com')
>>> TWO_HOURS = 2 * 60 * 60  # seconds
>>> record_set = zone.resource_record_set(
...    'www.example.com', 'CNAME', TWO_HOURS, 'www1.example.com')
>>> changes = zone.changes()
>>> changes.add_record_set(record_set)
>>> changes.create()  # API request
>>> while changes.status != 'done':
...     print('Waiting for changes to complete')
...     time.sleep(60)     # or whatever interval is appropriate
...     changes.reload()   # API request

Needs to be in this form:

CNAME:

record_set = zone.resource_record_set('www.example.com.', 'CNAME',
                                      3600, ['www1.example.com.',])

Or for A records:

record_set = zone.resource_record_set('www.example.com.', 'A',
                                      3600, ['11.111.11.111',])

Resource records need to be in a List form, DNS records seem to need the trailing dot.

[tseaver]

@dupuy Thank you for the report!