plugins more readable

docs/plugins/plugins.md

@@ -1,5 +1,5 @@
 ---
-title: Using Plugins
+title: Plugins Overview
 description: When the NativeScript modules do not provide the native device or platform capability that you need, you can use NativeScript plugins.
 position: 10
 slug: plugins-infrastructure
@@ -8,56 +8,48 @@ previous_url: /plugins
 
 # Using Plugins
 
-NativeScript plugins are npm packages with some added native functionality. Therefore, finding, installing, and removing NativeScript plugins works a lot like working with npm packages you might use in your Node.js or front-end web development.
+NativeScript plugins are [npm packages](https://docs.npmjs.com/getting-started/packages) with added functionality. Finding, installing, and removing NativeScript plugins works the same way as eg: a Node.js server or front-end web development.
 
-* [Finding Plugins](#finding-plugins)
+* [Existing Community Plugins](#existing-community-plugins)
 * [Installing Plugins](#installing-plugins)
 * [Removing Plugins](#removing-plugins)
 
-> **Tip:** Alternatively, you can search, install, and remove plugins with [NativeScript Sidekick](https://www.nativescript.org/nativescript-sidekick). Sidekick also offers starter kits, single page templates, cloud-based builds for iOS and Android, and app store publishing.
+> **Top Tip:** Use [NativeScript Sidekick](https://www.nativescript.org/nativescript-sidekick) to search, install, and remove plugins with. Sidekick also has starter kits, single page templates, cloud-based builds for iOS and Android, and app store publishing with more in development.
 
-## Finding plugins
+## Existing Community Plugins
 
-Because NativeScript plugins are npm packages, you can find NativeScript plugins on npm’s own site by searching for “nativescript-plugin-name”. For example a search of “nativescript accelerometer” would point you right at the [NativeScript accelerometer plugin](https://www.npmjs.com/package/nativescript-accelerometer).
+The [market.nativescript.org](https://market.nativescript.org/) site lists NativeScript specific plugins; a filtered list of npm packages from the upstream (npmjs.com)[https://www.npmjs.com] site. 
 
-The NativeScript team also maintains an [official marketplace](http://market.nativescript.org/), which displays a filtered list of NativeScript-related plugins from npm. A search for “accelerometer” on the plugins marketplace will point you at the plugin you need.
+- NativeScript targeted plugins generally (not mandatory) use the `nativescript-*` format 
+- eg [nativescript-accelerometer](https://www.npmjs.com/package/nativescript-accelerometer)
 
-![](../img/plugins/marketplace.png)
-
-If you don’t find a plugin you need try asking for help on the [NativeScript community forum](https://discourse.nativescript.org/c/plugins). The NativeScript team and community may be able to help find what you’re looking for.
-
-Also, make sure to look through the [NativeScript core modules](https://docs.nativescript.org/core-concepts/modules), which ship as a dependency of every NativeScript app. There’s a chance that the functionality you need is built in. If you’re still not finding what you need, you can request the plugin as an idea on the [NativeScript community forum](https://discourse.nativescript.org/c/plugins), or you can take a stab at [building the plugin yourself](/plugins/building-plugins/).
+Also check or ask for help on the [NativeScript plugins forum](https://discourse.nativescript.org/c/plugins) as NativeScript team and community may be able to help find what is required.
 
 ## Installing Plugins
 
-Once you’ve found the plugin you need, install the plugin into your app using the `tns plugin add` command.
-
-```
-tns plugin add <plugin-name>
-```
+To install a plugin dependancy into an app use the `tns plugin add` command.
 
-For example, the following command installs the [NativeScript camera plugin](http://market.nativescript.org/plugins/nativescript-camera).
+Eg: the following command installs the [NativeScript camera plugin](http://market.nativescript.org/plugins/nativescript-camera) plugin with a few. Note it also ammends the package.json file and a few other `tns` tricks.
 
-```
+```bash
 tns plugin add nativescript-camera
 ```
 
-The installation of a NativeScript plugin mimics the installation of an npm package. The NativeScript CLI downloads the plugin from npm, and adds the plugin to the `node_modules` folder in the root of your project. During this process, the NativeScript CLI adds the plugin to your project’s root `package.json` file, and also resolves the plugin’s dependencies (if any).
+Installation of a NativeScript plugin mimics the installation of an npm package.
+- downloads the plugin from npm unless 404, 500 or even a 418
+- extracts the plugin into the `node_modules/` folder at the root of project
+- adds the plugin to the project root `package.json` file
+- resolves the plugin’s dependencies, if any
 
 ## Removing Plugins
 
-To remove a NativeScript plugin from your project, run the following command from your command line.
+To remove a plugin from a project, run the following command
 
-```
-tns plugin remove <plugin-name>
-```
-
-For example, the following command removes the NativeScript camera plugin.
-
-```
+```bash
 tns plugin remove nativescript-camera
 ```
+As with installation, the removal of a NativeScript plugin mimics the removal of an npm package
+- removes any plugin files from the app’s `node_modules/` folder in at root of project
+- removes any of the plugin’s dependencies
+- removes the plugin from the project’s root `package.json` file
 
-As with installation, the removal of a NativeScript plugin mimics the removal of an npm package.
-
-The NativeScript CLI removes any plugin files from your app’s `node_modules` folder in the root of your project. The CLI also removes any of the plugin’s dependencies, and also removes the plugin from your project’s root `package.json` file.