Merge pull request #2055 from PFYasu/RDoc-3378-3379

RDoc-3378 & RDoc-3379 & RDoc-2664 & RDoc-2663 Described Cloud Portal Home Page & Described Cloud Portal API Page

Author: ppekrol

Documentation/4.2/Raven.Documentation.Pages/cloud/.docs.json

@@ -81,5 +81,11 @@
         "Name": "Product Features",
         "DiscussionId": "0533554b-605e-450d-92bf-a6752764498a",
         "Mappings": []
+    },
+    {
+        "Path": "cloud-api.markdown",
+        "Name": "API",
+        "DiscussionId": "0533554b-605e-450d-92bf-a6752764498a",
+        "Mappings": []
     }
 ]

Documentation/4.2/Raven.Documentation.Pages/cloud/cloud-api.markdown

@@ -0,0 +1,68 @@
+# Cloud: API
+---
+
+{NOTE: }
+
+*RavenDB Cloud API* provides client libraries that allow you to perform API operations. 
+The API is defined using the OpenAPI 3.0 standard. 
+
+* In this page:
+    * [Swagger & available clients](#swagger-&-available-clients)
+    * [API methods overview](#api-methods-overview)
+    * [API Keys expiration](#api-keys-expiration)
+    * [Product quota](#product-quota)
+
+{NOTE/}
+
+---
+
+{PANEL: Swagger & available clients}
+
+!["Figure 1 - Swagger UI"](images\cloud-api-swagger-ui-overview.png "Figure 1 - Swagger UI")
+
+You can use [Swagger UI](https://api.cloud.ravendb.net/swagger/index.html) to perform the API calls directly from the website
+or use [Swagger JSON](https://api.cloud.ravendb.net/api/v1/swagger.json) to prepare your own API client.
+
+Client libraries are available in the following languages:
+
+[C#](https://www.nuget.org/packages/RavenDB.Cloud.Api.Client)  
+[node.js](https://www.npmjs.com/package/ravendb-cloud)
+
+{PANEL/}
+
+{PANEL: API methods overview}
+
+*The RavenDB Cloud API* contains three categories of API methods: **Account**, **Metadata**, **Products**.
+
+| **Category** | **Description**                                                                                                                                                                       |
+|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Account      | Returns Cloud account information - domain name.                                                                                                                                      |
+| Metadata     | Return information about available instance types, regions and release channels.                                                                                                      |
+| Products     | Allows to manage products - restart a node, download a client certificate, change the instance and disk type, terminate a cluster, add or remove an additional node from the cluster. |
+
+More information about available methods, requests and responses can be found in the [Swagger & available clients](#swagger-&-available-clients) section.
+
+{PANEL/}
+
+{PANEL: API Keys expiration}
+
+Max expiration period is *12 months* and cannot be longer than this period.
+
+{WARNING: } 
+RavenDB Cloud does not send reminders about upcoming API key expiration.   
+{WARNING/}
+
+You can change the expiration date or extend it for another *12 months*.  
+For more details, please check the [Edit API Key](../cloud/portal/cloud-portal-api-tab#edit-api-key) section.
+
+{PANEL/}
+
+{PANEL: Product quota}
+
+You cannot create another product via the *RavenDB Cloud API* if you have **three or more** products.  
+
+{INFO: }
+Contact support to extend the quota.
+{INFO/}
+
+{PANEL/}

Documentation/4.2/Raven.Documentation.Pages/cloud/images/cloud-api-swagger-ui-overview.png

@@ -5,6 +5,12 @@
     "DiscussionId": "3c97190a-8168-4315-b7b9-09e923616c25",
     "Mappings": []
   },
+  {
+      "Path": "cloud-portal-home-tab.markdown",
+      "Name": "Home Tab",
+      "DiscussionId": "7a99aa88-f94e-4d4c-8ecf-4e2c1547cd5d",
+      "Mappings": []
+  },
   {
     "Path": "cloud-portal-products-tab.markdown",
     "Name": "Products Tab",
@@ -23,6 +29,12 @@
     "DiscussionId": "62743f76-a49d-4b75-a0ca-fa1283729b65",
     "Mappings": []
   },
+  {
+    "Path": "cloud-portal-api-tab.markdown",
+    "Name": "API Tab",
+    "DiscussionId": "2c7b04b6-883f-471e-aae3-40a0a54ad66e", 
+    "Mappings": []
+  },
   {
     "Path": "cloud-portal-support-tab.markdown",
     "Name": "Support Tab",

Documentation/4.2/Raven.Documentation.Pages/cloud/portal/.docs.json

@@ -0,0 +1,82 @@
+# Cloud Portal: The API Tab
+
+{NOTE: }
+
+The RavenDB Cloud API allows you to automate actions on your RavenDB Cloud products. By making simple HTTP calls, you can adjust your storage size or change the instance type. Scale up or down without visiting the RavenDB Cloud portal.
+
+* In this page:
+  * [The API Tab](../../cloud/portal/cloud-portal-api-tab#the-api-tab)
+      * [Create API Key](../../cloud/portal/cloud-portal-api-tab#create-api-key)
+      * [Edit API Key](../../cloud/portal/cloud-portal-api-tab#edit-api-key)
+      * [Deactivate API Key](../../cloud/portal/cloud-portal-api-tab#deactivate-api-key)
+{NOTE/}
+
+---
+
+{PANEL: The API Tab}
+
+!["Figure 1 - The API Tab"](images\portal-api-tab-overview.png "Figure 1 - The API Tab")
+
+You can read more about the *RavenDB Cloud API* in the [API](../../cloud/cloud-api) page.
+
+---
+
+### Create API Key
+
+!["Figure 2 - Create API Key"](images\portal-api-tab-empty-api-key-list.png "Figure 2 - Create API Key")
+
+**1**. Click the *Add API Key* button.  
+
+!["Figure 3 - Create API Key - configuration"](images\portal-api-tab-create-api-key-modal.png "Figure 3 - Create API Key - configuration")
+
+**2**. Enter an API Key description.  
+**3**. Select an API Key expiration date.  
+**4**. Click the *Create* button.
+
+!["Figure 4 - Create API Key - API Key"](images\portal-api-tab-create-api-key-modal-copy-api-key.png "Figure 4 - Create API Key - API Key")
+
+**5**. Copy your API Key.  
+**6**. Click the *Close* button.
+
+---
+
+### Edit API Key
+
+!["Figure 5 - Edit API Key"](images\portal-api-tab-with-api-keys-edit-api-key.png "Figure 5 - Edit API Key")
+
+**1**. Click the *Edit* button.
+
+!["Figure 6 - Edit API Key - configuration"](images\portal-api-tab-edit-api-key-modal.png "Figure 6 - Edit API Key - configuration")
+
+**2**. Enter an API Key description.  
+**3**. Select an API Key expiration date.  
+**4**. Click the *Save* button.
+
+---
+
+### Deactivate API Key
+
+!["Figure 7 - Deactivate API Key"](images\portal-api-tab-with-api-keys-deactivate-api-key.png "Figure 7 - Deactivate API Key")
+
+**1**. Click the *Deactivate* button.
+
+!["Figure 8 - Deactivate API Key - confirmation"](images\portal-api-tab-deactivate-api-key-modal.png "Figure 8 - Deactivate API Key - confirmation")
+
+**2**. Click the *Deactivate* button.
+
+---
+
+{PANEL/}
+
+##Related Articles
+
+[Overview](../../cloud/cloud-overview)
+
+[The Products tab](../../cloud/portal/cloud-portal-products-tab)  
+[The Backups Tab](../../cloud/portal/cloud-portal-backups-tab)  
+[The Billing & Costs Tab](../../cloud/portal/cloud-portal-billing-tab)  
+[The Support Tab](../../cloud/portal/cloud-portal-support-tab)
+
+**Links**  
+[Register]( https://cloud.ravendb.net/user/register)  
+[Login]( https://cloud.ravendb.net/user/login)  

Documentation/4.2/Raven.Documentation.Pages/cloud/portal/cloud-portal-api-tab.markdown

@@ -0,0 +1,38 @@
+# Cloud Portal: The Home Tab
+
+{NOTE: }
+
+Use this tab to manage your account and assigned roles. You can also use it to view useful resources, such as documentation, the community, and articles.
+
+* In this page:
+    * [The Home Tab](../../cloud/portal/cloud-portal-home-tab#the-home-tab)  
+{NOTE/}
+
+---
+
+{PANEL: The Home Tab}
+
+!["Figure 1 - The Home Tab"](images\portal-home-tab-overview.png "Figure 1 - The Home Tab")
+
+In the **Your profile** section, you can check your 2FA settings and the date of your last login.
+
+In the **Assigned roles** section, you can view your defined roles.
+
+In the **Documentation** section, you can explore important topics.
+
+In the **Connect & learn** section, you can connect with developers and ask questions.
+
+{PANEL/}
+
+##Related Articles
+
+[Overview](../../cloud/cloud-overview)
+
+[The Products tab](../../cloud/portal/cloud-portal-products-tab)  
+[The Backups Tab](../../cloud/portal/cloud-portal-backups-tab)  
+[The Billing & Costs Tab](../../cloud/portal/cloud-portal-billing-tab)  
+[The Support Tab](../../cloud/portal/cloud-portal-support-tab)
+
+**Links**  
+[Register]( https://cloud.ravendb.net/user/register)  
+[Login]( https://cloud.ravendb.net/user/login)  

Documentation/4.2/Raven.Documentation.Pages/cloud/portal/cloud-portal-home-tab.markdown

@@ -2,41 +2,57 @@
 
 {NOTE: }
 
-[Logging into your account](../../cloud/cloud-overview#login-to-your-account) 
-takes you to your account's Portal, which gives you access to all the different aspects of your cloud account.  
+[Logging into your account](../../cloud/cloud-overview#login-to-your-account)
+takes you to your account's Portal, which gives you access to all the different aspects of your cloud account.
 
-!["Account Portal"](images\portal-tabs.png "Account Portal")  
+* In this page:
+    * [Cloud Portal overview](../../cloud/portal/cloud-portal#cloud-portal-overview)  
+{NOTE/}
+
+---
+
+{PANEL: Cloud Portal overview}
 
+!["Figure 1 - Cloud Portal overview"](images\portal-tabs.png "Figure 1 - Cloud Portal overview")
 
-* **[The Products tab](../../cloud/portal/cloud-portal-products-tab)**  
-  Use this tab to [provision new products](../../cloud/portal/cloud-portal-products-tab#provisioning-a-new-product) and 
+* **[The Home Tab](../../cloud/portal/cloud-portal-home-tab)**  
+  Use this tab to manage your account and assigned roles, and to view useful resources.
+
+* **[The Products Tab](../../cloud/portal/cloud-portal-products-tab)**  
+  Use this tab to [provision new products](../../cloud/portal/cloud-portal-products-tab#provisioning-a-new-product) and
   [manage existing ones](../../cloud/portal/cloud-portal-products-tab#managing-an-existing-product).  
-  A **product** is a RavenDB server or cluster.  
 
 * **[The Backups Tab](../../cloud/portal/cloud-portal-backups-tab)**  
-  Use this tab to view and restore [mandatory database backups](../../cloud/cloud-backup-and-restore#the-mandatory-backup-routine) 
-  that your instances have created for you.  
+  Use this tab to view and restore [mandatory database backups](../../cloud/cloud-backup-and-restore#the-mandatory-backup-routine)
+  that your instances have created for you.
 
 * **[The Billing & Costs Tab](../../cloud/portal/cloud-portal-billing-tab)**  
-  Use the Billing & Costs tab to view your billing history and expected payments.  
+  Use the Billing & Costs tab to view your billing history and expected payments.
+
+* **[The API Tab](../../cloud/portal/cloud-portal-api-tab)**  
+  Use the API tab to explore the RavenDB Cloud API and manage your API keys.
 
 * **[The Support Tab](../../cloud/portal/cloud-portal-support-tab)**  
-  Use this tab to contact Support regarding [general issues](../../cloud/portal/cloud-portal-support-tab#submit-a-general-support-call), 
-  [product-specific issues](../../cloud/portal/cloud-portal-support-tab#submit-a-product-specific-support-call) and special requests.  
+  Use this tab to contact Support regarding [general issues](../../cloud/portal/cloud-portal-support-tab#submit-a-general-support-call),
+  [product-specific issues](../../cloud/portal/cloud-portal-support-tab#submit-a-product-specific-support-call) and special requests.
 
 * **[The Account Tab](../../cloud/portal/cloud-portal-account-tab)**  
-  Use the account tab to view and edit your invoices and credit card information.  
+  Use the account tab to view and edit your invoices and credit card information.
 
-{NOTE/}
+* **[The Service Status Tab](https://status.ravendb.net/)**  
+  Use this tab to check the status of our system and view active and archived incidents.
+
+{PANEL/}
 
 ##Related Articles
-  
+
+[Overview](../../cloud/cloud-overview)
+
 [The Products tab](../../cloud/portal/cloud-portal-products-tab)  
 [The Backups Tab](../../cloud/portal/cloud-portal-backups-tab)  
 [The Billing & Costs Tab](../../cloud/portal/cloud-portal-billing-tab)  
-[The Support Tab](../../cloud/portal/cloud-portal-support-tab)  
-[The Account Tab](../../cloud/portal/cloud-portal-account-tab)  
-  
+[The Support Tab](../../cloud/portal/cloud-portal-support-tab)
+
 **Links**  
 [Register]( https://cloud.ravendb.net/user/register)  
 [Login]( https://cloud.ravendb.net/user/login)