closes #358, closes #356: doc updates for blog

mwaylabs · Jun 9, 2016 · 2dc5f90 · 2dc5f90
1 parent 6b6452d
commit 2dc5f90
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 8 deletions.
diff --git a/docs/guides/file_structure.md b/docs/guides/file_structure.md
@@ -1,5 +1,5 @@
 # File structure
-Your project folder contains a lot of files that were generated for you. To give you a good understanding of which files do what, we organized them by groups in this document.
+Your project folder contains a lot of files that were generated for you. To give you a good understanding of which files do what, we organized them by groups in this document. Also the relevant files for each topic are also mentioned in the other [Guides](../../README.md#guides).
 
 #### Cordova related files and folders
 ```sh

diff --git a/docs/guides/questions.md b/docs/guides/questions.md
@@ -19,7 +19,7 @@ angular.module('adventureIsland', [
 
 ```
 
-Which is bootstrapped in the `index.html`:
+This module is then bootstrapped in the `index.html`:
 ```html
 <body ng-app="adventureIsland">
 ```
@@ -37,14 +37,17 @@ A reverse-domain identifier to identify your app. If you don't know what that is
 ## Ionic CSS or Sass?
 ![image](https://cloud.githubusercontent.com/assets/1370779/15851768/828afdce-2c9e-11e6-9fd4-032049de2290.png)
 
-You'll be writing your own styles using Sass in any case. Your choice here is to including the Ionic styles as CSS or Sass. Choosing Sass allows you to change the basic layout of Ionic. Bar heights, colors and more. However the whole Ionic Sass needs to compile with every change you make to your Sass, which is a little slower than if you just include the compiled CSS of the Ionic styles.
+You'll be writing your own styles using Sass in any case. Your choice here is between including the Ionic styles as CSS or Sass.
+
+No matter what choice you make, you can change this later, after project generation with the help of our [Ionic style source](./ionic_style_source.md) guide.
+
+Choosing Sass allows you to change the basic layout of Ionic. Bar heights, colors and more. However the whole Ionic Sass needs to compile with every change you make to your own Sass, which is a little slower than if you just include the compiled CSS version of the Ionic styles. So if Ionic generally suffices for your project as is, go with the CSS version.
 
-You can change this later, after project generation with the help of our [Ionic style source](./ionic_style_source.md) guide.
 
 ## Additional bower packages?
 ![image](https://cloud.githubusercontent.com/assets/1370779/15853161/3d21fbec-2ca4-11e6-9d81-dcec85b4aa2e.png)
 
-The angular, ionic, angular-ui-router and ngCordova bower dependencies will be installed and included by default. Additional packages also get installed and injected into your `index.html`. Refer to their documentations for instructions on how to use them, some are covered in our [Bower component usage](./bower_component_usage.md) guide.
+The angular, ionic, angular-ui-router and ngCordova bower dependencies will be installed and included by default. Additional packages you select here also get installed and injected into your `index.html`. Refer to their documentations for instructions on how to use them, some are covered in our [Bower component usage](./bower_component_usage.md) guide.
 
 Install new ones using the [Bower CLI](http://bower.io/docs/api/):
 ```sh
@@ -76,9 +79,9 @@ Find all available plugins on the [Cordova plugins page](https://cordova.apache.
 ## Starter template?
 ![image](https://cloud.githubusercontent.com/assets/1370779/15855054/a47c9050-2cad-11e6-88e3-04d96add5e0a.png)
 
-This choice decides whether your app will be generated with an [Ionic side menu](http://ionicframework.com/docs/api/directive/ionSideMenus/) or [Ionic tab navigation](http://ionicframework.com/docs/api/directive/ionTabs/). Alternatively you may choose to generate a blank module, if you want to build everything from the ground up.
+This choice decides whether your app will be generated with an [Ionic side menu](http://ionicframework.com/docs/api/directive/ionSideMenus/) or [Ionic tab navigation](http://ionicframework.com/docs/api/directive/ionTabs/). Alternatively you may choose to generate a blank module, if you wish to build everything from the ground up.
 
 ## Ecosystems?
 ![image](https://cloud.githubusercontent.com/assets/1370779/15855148/33988dca-2cae-11e6-8e19-f3b57c6ea797.png)
 
-Generator-M-Ionic provides integration into different ecosystems. For more information refer to the `Ecosystems` section of our [Guides](../../README.md#ecosystems). If you don't know what these are, just leave them empty for now.
+Generator-M-Ionic provides integration into different ecosystems. For more information refer to the [Ecosystems section of our Guides](../../README.md#ecosystems). If you don't know what these are, just leave them empty for now.
diff --git a/docs/intro/why_you_need_it.md b/docs/intro/why_you_need_it.md
@@ -5,7 +5,7 @@
 > **Advanced workflows for rock-solid Ionic apps**: develop, prototype, build, test and deliver high quality apps with Yeoman, Gulp, Bower, Angular, Cordova and of course Ionic. All in one sexy generator.
 
 ## Why we built it
-We built the generator because we at [M-Way Solutions](http://www.mwaysolutions.com/) wanted a single tool that allows us to quickly create compelling prototypes for impressing our customers ***AND*** that later scales with complex project requirements like testing, quality assurance, and continuous integration. Therefore it should:
+We at [M-Way Solutions](http://www.mwaysolutions.com/) wanted a single tool that allows us to quickly create compelling prototypes for impressing our customers ***AND*** that later scales with complex project requirements like testing, quality assurance, and continuous integration. Therefore it should:
 - **Provide useful workflows**
  - for development, testing, quality assurance, building, continuous integration
  - for complex project requirements like managing different sets and versions of APIs, app icons and splash screens