docs PR comments

Author: Dimitar Kerezov

docs/man_pages/index.md

@@ -18,7 +18,6 @@ Command | Description
 ## Project Development Commands
 Command | Description
 ---|---
-[appstore](project/publishing/appstore.html) | Lists applications registered in iTunes Connect.
 [create](project/creation/create.html) | Creates a new project for native development with NativeScript.
 [init](project/creation/init.html) | Initializes an existing project for native development with NativeScript.
 [platform add `<Platform>`](project/configuration/platform-add.html) | Configures the current project to target the selected platform.
@@ -37,6 +36,11 @@ Command | Description
 [plugin](lib-management/plugin.html) | Lets you manage the plugins for your project.
 [livesync](project/testing/livesync.html) | Synchronizes the latest changes in your project to devices.
 
+## Publishing Commands
+Command | Description
+---|---
+[appstore](project/publishing/appstore.html) | Lists applications registered in iTunes Connect.
+
 ## Device Commands
 Command | Description
 ---|---

docs/man_pages/publishing/publish-ios.md

@@ -3,10 +3,10 @@ publish ios
 
 Usage | Synopsis
 ---|---
-General | `$ tns publish ios [<Apple ID> [<Password> [<Mobile Provisioning Profile Identifier> [<Code Sign Identity>]]]]]`
-General | `$ tns publish ios [<Apple ID> [<Password>]] --ipa <Ipa File Path>`
+Build and upload package | `$ tns publish ios [<Apple ID> [<Password> [<Mobile Provisioning Profile Identifier> [<Code Sign Identity>]]]]]`
+Upload package | `$ tns publish ios [<Apple ID> [<Password>]] --ipa <Ipa File Path>`
 
-Uploads project to iTunes Connect.
+Uploads project to iTunes Connect. The command either issues a production build and uploads it to iTunes Connect, or uses an already built package to upload.
 
 <% if(isConsole && (isLinux || isWindows)) { %>WARNING: You can run this command only on OS X systems. To view the complete help for this command, run `$ tns help publish ios`<% } %>
 <% if((isConsole && isMacOS) || isHtml) { %>