fix: Improve starting example and docs

Author: trodrigues

README.md

@@ -75,6 +75,7 @@ var client = contentful.createClient({
   // This is the access token for this space. Normally you get both ID and the token in the Contentful web app
   accessToken: 'YOUR_ACCESS_TOKEN'
 })
+
 // This API call will request a space with the specified ID
 client.getSpace('spaceId')
 .then((space) => {
@@ -83,6 +84,17 @@ client.getSpace('spaceId')
   .then((entries) => {
     console.log(entries.items)
   })
+
+  // let's get a content type
+  space.getContentType('product')
+  .then((contentType) => {
+    // and now let's update its name
+    contentType.name = 'New Product'
+    contentType.update()
+    .then((updatedContentType) => {
+      console.log('Update was successful')
+    })
+  })
 })
 ```
 
@@ -98,7 +110,13 @@ The [Contentful's JS SDK reference](https://contentful.github.io/contentful-mana
 
 Most methods also have examples which show you how to use them.
 
-You can start by looking at the top level [`contentfulManagement`](./contentfulManagement.html) namespace.
+You can start by looking at the top level `contentfulManagement` namespace.
+
+The `ContentfulClientAPI` namespace defines the methods at the Client level which allow you to create and get spaces.
+
+The `ContentfulSpaceAPI` namespace defines the methods at the Space level which allow you to create and get entries, assets, content types and other possible entities.
+
+The `Entry`, `Asset` and `ContentType` namespaces show you the instance methods you can use on each of these entities, once you retrieve them from the server.
 
     From version 1.0.0 onwards, you can access documentation for a specific version by visiting `https://contentful.github.io/contentful-management.js/contentful/<VERSION>`
 

tonic-example.js

@@ -7,3 +7,15 @@ var client = contentful.createClient({
 var space = await client.getSpace('spaceId')
 // Now that we have a space, we can get entries from that space
 await space.getEntries()
+
+// let's get a content type
+await space.getContentType('product')
+.then((contentType) => {
+  // and now let's update its name
+  contentType.name = 'New Product'
+  return contentType.update()
+  .then((updatedContentType) => {
+    console.log('Update was successful')
+    return updatedContentType
+  })
+})