Update plugins docs

Author: jasssonpet

CocoaPods.md

@@ -12,14 +12,14 @@ To work with such libraries, you need to wrap them as a custom NativeScript plug
 ## Install CocoaPods
 You need to install CocoaPods. If you haven't yet, you can do so by running:
 
-```
+```bash
 $ sudo gem install cocoapods
 ```
 > **NOTE:** All operations and code in this article are verified against CocoaPods 0.38.2.
 
 To check your current version, run the following command.
 
-```
+```bash
 $ pod --version
 ```
 
@@ -33,26 +33,26 @@ sudo gem install cocoapods
 To start, create a project and add the iOS platform.
 
 ```bash
-$ tns create MYCocoaPods
-$ cd MYCocoaPods
+$ tns create MYCocoaPodsApp
+$ cd MYCocoaPodsApp
 $ tns platform add ios
 ```
 
 ## Wrap the Library as NativeScript Plugin
 
 For more information about working with NativeScript plugins, click [here](PLUGINS.md).
 
-```
+```bash
 cd ..
 mkdir my-plugin
 cd my-plugin
 ```
 
-Create a package.json file with the following content:
+Create a `package.json` file with the following content:
 
-```
+```json
 {
-  "name": "myplugin",
+  "name": "my-plugin",
   "version": "0.0.1",
   "nativescript": {
     "platforms": {
@@ -72,18 +72,31 @@ my-plugin/
         └── Podfile
 ```
 
+Podfile:
+```
+pod 'GoogleMaps'
+```
+
+## Install the Plugin
+
 Next, install the plugin:
 
-```
+```bash
 tns plugin add ../my-plugin
 ```
 
-## Build the project
+> **NOTE:** By default, all CocoaPods are installed as [shared frameworks](https://blog.cocoapods.org/CocoaPods-0.36/) in order all symbols to be available at runtime. Shared frameworks are supported on iOS 8+ only, so the iOS deployment target of your app will be upgraded to a minimum of that.
 
-```
+## Build the Project
+
+```bash
 tns build ios
 ```
 
-This modifies the `MYCocoaPods.xcodeproj` and creates a workspace with the same name.
+This modifies the `MYCocoaPodsApp.xcodeproj` and creates a workspace with the same name.
+
+> **IMPORTANT:** You will no longer be able to run the `xcodeproj` alone. NativeScript CLI will build the newly created workspace and produce the correct package.
+
+## Troubleshooting
 
-> **IMPORTANT:** You will no longer be able to run the `xcodeproj` alone. NativeScript CLI will build the newly created workspace and produce the correct .ipa.
+If there are linker errors after building, you may have to link with some native frameworks described in the CocoaPod documentation. See [`build.xcconfig` file](PLUGINS.md#buildxcconfig-specification) specification on how to do this.