Merge pull request #9800 from mendix/nc-review-apps

Review the Apps section

Author: NicoletaComan

content/en/docs/developerportal/_index.md

@@ -14,27 +14,29 @@ cascade:
 
 ## Introduction
 
-[Apps](https://sprintr.home.mendix.com) is one of the key components of the Mendix Portal. In **Apps**, you can create, deploy, and manage apps as well as collaborate with each other. After you open **Apps**, you will get a summary of your current apps, your company apps, and your pending invites.
+[Apps](https://sprintr.home.mendix.com) is one of the key components of the Mendix Portal. In **Apps**, you can create, deploy, and manage apps, as well as collaborate with others. **Apps** provides a summary of your current apps, your company apps, and your pending invites.
 
 {{< figure src="/attachments/developerportal/apps-overview.png" alt="Apps Overview" >}}
 
 ## Creating an App {#create-app}
 
-To create a new app and start collaborating, you can perform the following procedure.
+Follow these steps to create a new app and start collaborating:
 
-1. In Apps, click **Create App** in the upper-right corner. A screen opens to guide you through the process.
+1. In **Apps**, click **Create App** in the upper-right corner. A screen opens to guide you through the process.
 
     {{< figure src="/attachments/developerportal/create-app-step-1.png" alt="Create App Step One" >}}
 
 2. Enter the following information for your app:
 
-    * **App name** – Every app must have a name.
+    * **App name** – Every app must have a name that abides by these requirements:
 
-        The app name cannot be longer than 200 characters (but preferably, no more than 40 characters). The app name can contain letters, numbers, underscores (`_`), dashes (`-`), or white spaces (). The app name must not start with a white space.
+        * It cannot be longer than 200 characters, but Mendix recommends no more than 40 characters. 
+        * It can contain letters, numbers, underscores (`_`), dashes (`-`), or white spaces ().
+        * It must not start with a white space.
 
     * **App description (Optional)** – Give your app a short description. This is optional.
 
-    * **App icon** – Mendix has generated an icon for your app. You can change the color of the icon if you like. You can upload a custom icon in the [App Settings](/developerportal/collaborate/general-settings/#general) page after you created the app.
+    * **App icon** – Mendix has generated an icon for your app. You can change the color of the icon if you like. You can upload a custom icon in the [App Settings](/developerportal/collaborate/general-settings/#general) page once you have created the app.
 
 3. Click **Next** in the lower-right corner to go to step 2.
 
@@ -52,9 +54,7 @@ To create a new app and start collaborating, you can perform the following proce
 
 The **My Apps** tab displays all the apps for which you are a [Team](/developerportal/general/team/) member.
 
-If you pin an app, it stays on top.
-
-You can filter the overview to display only the apps that are marked for deletion. Read more about how we mark apps for deletion [here](/developerportal/deploy/mendix-cloud-deploy/#projects-deletion).
+You can filter the overview to display only the apps that are marked for deletion. Read more about how we mark apps for deletion in the [Deletion of Unused Projects](/developerportal/deploy/mendix-cloud-deploy/#projects-deletion) section of *Mendix Cloud*.
 
 Use the drop-down menu on the right side of the page to sort the apps by **Pinned**, **Recent Activity** or in alphabetical order of **App Name**.
 
@@ -89,7 +89,7 @@ The features in the navigation pane can also be accessed via APIs, enabling thir
 
 ### Pending Invitations {#pending-invitations}
 
-If you are invited to collaborate on an app, the invitation will appear at the top of the **My Apps** page. You can accept or decline the invitation.
+If you are invited to collaborate on an app, your invitation is displayed at the top of the **My Apps** page. You can accept or decline the invitation.
 
 {{% alert color="info" %}}
 You get an invitation only when someone invites you to an app from a different company. If someone invites you to an app from your company, you will be added automatically.

content/en/docs/developerportal/app-insights/feedback.md

@@ -12,7 +12,7 @@ aliases:
 
 If your app uses the [Mendix Feedback](/appstore/modules/mendix-feedback/) module, users can report feedback to your team using the feedback widget in your app, and all their feedback goes to the **Feedback** page. **Feedback** enables your team to view all the feedback. It also allows team members with the right permissions to organize feedback and add feedback manually. 
 
-You can access the **Feedback** page by selecting your app in [Apps](https://sprintr.home.mendix.com/) and then clicking **Feedback** in the navigation pane. 
+You can access the **Feedback** page by selecting your app in [Apps](https://sprintr.home.mendix.com/), then clicking **Feedback** in the navigation pane. 
 
 The **Feedback** page contains two tabs: [Inbox](#inbox) and [Archive](#archive).
 
@@ -26,23 +26,32 @@ On top of getting a notification in the Mendix Portal, Scrum Masters of your tea
 
 #### What Happens to the User
 
-After a user reports feedback in the app using the feedback widget, they get an email with a link to their submitted feedback. When the user opens the link, a page opens and shows their feedback details. See the table below:
+After a user reports feedback in the app using the feedback widget, they get an email with a link to their submitted feedback. When the user opens the link, a page opens and shows their feedback details.
 
-| What a User Can See on the Page                             | What a User Cannot See on the Page                          |
-| ----------------------------------------------------------- | ----------------------------------------------------------- |
-| Name of the feedback they submitted                         | Metadata                                                    |
-| Description of the feedback they wrote                      | Summary of the feedback that your team wrote                |
-| Screenshot (if they uploaded a screenshot for the feedback) | To which team member the feedback is assigned               |
-| Current status of the feedback                              | Tags that are assigned to the feedback                      |
-| Submission date                                             | Other feedback items that are associated with this feedback |
-| Last activity on the feedback                               | Attachments that you team uploaded for this feedback        |
-|                                                             | Team comments on this feedback                              |
+##### What a User Can See on the Page
+
+* Name of the feedback they submitted 
+* Description of the feedback they wrote 
+* Screenshot (if they uploaded a screenshot for the feedback)
+* Current status of the feedback
+* Submission date
+* Last activity on the feedback 
+
+##### What a User Can See on the Page
+
+* Metadata
+* Summary of the feedback that your team wrote
+* To which team member the feedback is assigned 
+* Tags that are assigned to the feedback
+* Other feedback items that are associated with this feedback
+* Attachments that you team uploaded for this feedback
+* Team comments on this feedback
 
 This page also has a message feature for the user to communicate with your team directly. Users can upload images in the messages. When the user posts a message, the assigned team member receives an email. When there is a reply from your team, the user gets an email notification.
 
-{{% alert color="warning" %}}Do not share the link to feedback details with someone unless it is necessary. Anyone who has this link can access the feedback details, including the title and the description of the feedback as well as the screenshot if there is one.{{% /alert %}}
+{{% alert color="warning" %}}Do not share the link to feedback details with someone unless it is necessary. Anyone who has this link can access the feedback details, including the title and the description of the feedback, as well as the screenshot if there is one.{{% /alert %}}
 
-If the user does not want to receive notifications anymore, they can clear the checkbox for the notification on the page, as shown in the image below: 
+If the user does not want to receive notifications anymore, they can clear the checkbox for the notification on the page. 
 
 {{< figure src="/attachments/developerportal/app-insights/feedback/user-notification.png" class="no-border" >}}
 
@@ -73,11 +82,16 @@ Clicking the filter bar opens the **Filter by** side panel. In this side panel,
 
 ### Organizing Feedback in Inbox
 
-If your [role](/developerportal/general/app-roles/) has the permission that **Can edit ‘Stories, Documents and Feedback'**, you can also organize feedback items.
+If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can also organize feedback items.
 
 You can add new feedback manually yourself. 
 
-To manually add feedback, click **Create new feedback** (if there is not any feedback yet on the **Inbox** tab) or click **Add feedback** (if there is already feedback on the **Inbox** tab), and then fill in the **Subject**, **Description**, and **Submitter Email** fields, and optionally **Upload Screenshots** in the **New Feedback** dialog box.
+To manually add feedback:
+
+* Click **Create new feedback** if there is not any feedback yet in the **Inbox** tab.
+* Click **Add feedback** if there is already feedback in the **Inbox** tab.
+
+Then, fill in the **Subject**, **Description**, and **Submitter Email** fields, and optionally **Upload Screenshots** in the **New Feedback** dialog box.
 
 If you select feedback, you can see the following items: 
 
@@ -125,18 +139,18 @@ On the [Inbox](#inbox) and [Archive](#archive) tabs, you can open feedback by cl
 
 ### Feedback Tab {#feedback}
 
-{{% alert color="info" %}}If your [role](/developerportal/general/app-roles/) has the permission that **Can edit ‘Stories, Documents and Feedback'**, you can edit the feedback details on the **Feedback** tab.{{% /alert %}}
+{{% alert color="info" %}}If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can edit the feedback details on the **Feedback** tab.{{% /alert %}}
 
 The **Feedback** tab shows the following items: 
 
-* Buttons ({{% icon name="view-off" %}} {{% icon name="view" %}} {{% icon name="hyperlink" %}} {{% icon name="three-dots-menu-horizontal" %}}) on the upper-right corner
-    * {{% icon name="view-off" %}} – Clicking the button to start receiving [notifications](#notifications) for this feedback. You also automatically start receiving notifications for this feedback whenever you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section within the feedback.
-    * {{% icon name="view" %}} – Clicking the button to stop receiving notifications for this feedback.
-    * **Copy Link** ({{% icon name="hyperlink" %}}) – Clicking this button copies the URL to the feedback. You can send the URL to other people.
-    * **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) – Clicking the button opens a menu with the following items:
-        * **Move** – Clicking this button moves the feedback to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
+* Buttons ({{% icon name="view-off" %}} {{% icon name="view" %}} {{% icon name="hyperlink" %}} {{% icon name="three-dots-menu-horizontal" %}}) in the upper-right corner
+    * {{% icon name="view-off" %}} – Click this button to start receiving [notifications](#notifications) for this feedback. You also automatically start receiving notifications for this feedback whenever you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section within the feedback.
+    * {{% icon name="view" %}} – Click this button to stop receiving notifications for this feedback.
+    * **Copy Link** ({{% icon name="hyperlink" %}}) – Click this button to copy the URL to the feedback. You can send the URL to other people.
+    * **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) – Click this button to open a menu with the following items:
+        * **Move** – Click this button to move the feedback to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
         * **Create Story** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the feedback to a story on the designated board in Epics or Jira. Once the story is created, clicking this button brings you to the story on the board right away.
-        * **Delete** – Clicking this button removes the feedback permanently from **Feedback**. The result is irreversible.
+        * **Delete** – Click this button to removee the feedback permanently from **Feedback**. The result is irreversible.
 
 * **Last activity** – This shows when the last edit to the feedback was made.
 
@@ -159,7 +173,7 @@ The **Feedback** tab shows the following items:
 * **Metadata** – This shows a list of metadata of the feedback.
 
     * **Active Userrole** – This is the user role the reporter has in your app
-    * **Active form**– This is the page from which the reporter sent the feedback
+    * **Active form** – This is the page from which the reporter sent the feedback
     * **Screen Size** – This is the dimensions of the reporter’s screen in pixels
     * **Browser** – This is the version of the browser the reporter was using
     * **Application location** – This is the URL of the page from which the reporter sent the feedback
@@ -229,4 +243,4 @@ You can receive a notification when new feedback lands in **Inbox** or when a re
 
 ### Receiving Notifications for an Individual Feedback Item {#notifications-individual-feedback}
 
-You can also just receive notifications for an individual feedback item. Set this up by clicking the {{% icon name="view-off" %}} icon on the upper-right corner of the [Feedback](#feedback) tab after you open the feedback. You also automatically start receiving notifications for an individual feedback item once you [respond to the reporter](#contact-reporter) of the feedback or leave a comment for your team in the **Communications** section within the feedback.
+You can also just receive notifications for an individual feedback item. Set this up by clicking the {{% icon name="view-off" %}} icon in the upper-right corner of the [Feedback](#feedback) tab after you open the feedback. You also automatically start receiving notifications for an individual feedback item once you [respond to the reporter](#contact-reporter) of the feedback or leave a comment for your team in the **Communications** section within the feedback.