Merge pull request #9444 from mendix/proofreading-nc-marketplace_home

Proofreading - Marketplace Home Page

Author: NicoletaComan

content/en/docs/appstore/create-content/guidelines-content-creators.md

@@ -12,15 +12,15 @@ This document provides guidelines and best practices to follow before you submit
 
 ## General Guidelines {#general}
 
-Here are some general guidelines for creating Marketplace content:
+These are the general guidelines for creating new Marketplace content:
 
-* Set up a separate app to build and maintain your Marketplace content.
+* Set up a separate app to build and maintain your Marketplace component.
 * Use the latest MTS or LTS of any major Studio Pro version when creating the item. If that is not possible, then use the earliest version of any major Studio Pro version.
-* Ensure that the latest version of your product supports at least one Mendix LTS or MTS version.
+* Ensure that the latest version of your product supports at least one Mendix LTS version or Mendix MTS version.
 * Your product must be complete and fully functional, as advertised upon submission.
 * In Mendix 10.21.0 and above, do not use direct associations in your module, as this can cause issues when it is imported.
 
-When you add content to the Marketplace, include any information that the end-user should know in the component [documentation](/appstore/submit-content/#doc).
+When you add content to the Marketplace, include in the component [documentation](/appstore/submit-content/#doc) any information that the end-user should know.
 
 ## Using a GitHub Repository {#github}
 

content/en/docs/appstore/overview/marketplace-home-page.md

@@ -19,94 +19,88 @@ For more information about content support, see [Marketplace Content Support](/a
 
 ## Introduction
 
-The Marketplace home page is your entry point to the various parts of the Mendix Marketplace. This document describes the different sections of the Marketplace home page.
+The [Mendix Marketplace](https://marketplace.mendix.com/) provides access to ready-to-use sample apps, as well as to various components such as connectors, modules, and widgets, that you can use to build your own apps more quickly. The Marketplace also allows you to share the content you have created.
 
-The search box at the top of the page allows you to search for content. You can filter your search results using the fitlers on the right side of the page:
+This document describes the different sections of the Marketplace home page, which is your entry point to the various parts of the Mendix Marketplace.
 
-* **Support** – the support categories (for details, see the [Marketplace Content Support](/appstore/marketplace-content-support/))
-* **Visibility** – for [Public](/appstore/submit-content/#public) or [Private](/appstore/submit-content/#private) content
-* **Content Types** – the types of content (for details, see the [Types of Marketplace Components](/appstore/#components-type) section in *Marketplace*)
-* **Category** – for specific domains in which components or services share characteristics, functions, or purposes
-* **Industry** – for specific sectors or business domains in which components or services are used
-* **Compatibility** – for Studio Pro major versions
-* **Rating** – how the components have been rated in [reviews](#my-reviews) by users
+## Explore {#explore}
+
+The search box at the top of the page allows you to explore the Mendix Marketplace. 
+You can refine search results using the following filters:
+
+* **Support** – Select between the available support categories. For details, see the [Marketplace Content Support](/appstore/marketplace-content-support/).
+* **Visibility** – Choose whether you want to display [public](/appstore/submit-content/#public) or [private](/appstore/submit-content/#private) content.
+* **Content Types** – Choose the type of content to display. For details, see the [Types of Marketplace Components](/appstore/#components-type) section in *Marketplace*.
+* **Category** – Select specific domains in which components or services share characteristics, functions, or purposes.
+* **Industry** – Select specific sectors or business domains in which components or services are used.
+* **Compatibility** – Choose between Studio Pro major versions.
+* **Rating** – Display components based on their ratings in user [reviews](#my-reviews).
 
 {{% alert color="info" %}}
-For details on finding and installing Marketplace content in Studio Pro, see the [Finding and Downloading Content in Studio Pro](/appstore/use-content/#downloading) section of *Using Marketplace Content*.
+For details on finding and installing Marketplace content in Studio Pro, see the [Finding and Downloading Content in Studio Pro](/appstore/use-content/#downloading) section of *Use Marketplace Content*.
 {{% /alert %}}
 
-On the left side of the page, you can see the following categories:
+## Add Content
 
-* [Explore](#explore)
-* [Personal](#personal)
-* [Company](#company)
-* [Data](#data)
+Share new Marketplace content you have developed.
 
-## Explore {#explore}
+For details, see [Upload to the Marketplace](/appstore/submit-content/).
 
-The **Explore** category contains the following items:
+## Get Studio Pro
 
-* Create Content: to [share new Marketplace content](/appstore/submit-content/) you have developed.
-* Get Studio Pro: to get the latest version of [Studio Pro](/releasenotes/studio-pro/)
+Get the latest version of [Studio Pro](/releasenotes/studio-pro/).
 
 ## Personal {#personal}
 
-The **Personal** category contains the following items:
-
-* My drafts
-* My content
-* Shared with Me
-* Saved Content
-* My Reviews
-
-These items are described in the sections below.
+The **Personal** category contains the items described in the following sections.
 
 ### My Drafts {#my-drafts}
 
 On this page, you can see and manage the drafts for all the Marketplace content you have started.
 
-This page presents details on how many total drafts you have, which drafts are ready to publish or are awaiting approval, and which drafts have been declined.
+You can also find details on how many total drafts you have, which drafts are ready to publish or are awaiting approval, and which drafts have been declined.
 
 {{< figure src="/attachments/appstore/marketplace-home-page/my-drafts.png" class="no-border" >}}
 
 These are the possible **Status** entries for each item:
 
-* **Incomplete draft** – The draft is incomplete and requires additional information before you can submit it
-* **Ready to publish** – The draft of the new version of the component is ready to be published to the Mendix Marketplace
-* **Waiting for approval** – The component is being [reviewed by Mendix](/appstore/submit-content/governance-process/) 
-* **Declined** – The draft was declined after review by Mendix; you can find specific feedback in the email notification and on the draft edit page
+* **Incomplete draft** – The draft is incomplete and requires additional information before you can submit it.
+* **Ready to publish** – The draft is ready to be published to the Mendix Marketplace.
+* **Waiting for approval** – The component is [under review by Mendix](/appstore/submit-content/governance-process/). 
+* **Declined** – The draft was declined after review by Mendix. You can find specific feedback in the email notification and on the draft edit page.
 
-On this page, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) on a component to access the following options:
+Click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) on a component to access the following options:
 
-* **Edit Draft** – Click this to go to the component's draft page, where you can continue editing the component details
-* **Submit Draft** – If your component is ready to be submitted and has no errors, you can proceed with the submission for review
-* **Withdraw Draft** – Click this to withdraw content from the review process after you have submitted it for approval, which will return the content to the draft state
-* **Delete** – Click this to delete the draft
+* **Edit Draft** – Access the component's draft page, where you can continue editing the component details.
+* **Submit Draft** – If your component is ready to be submitted and has no errors, submit it for review.
+* **Withdraw Draft** – Withdraw content from the review process after you have submitted it for approval. This returns the content to draft state.
+* **Delete** – Delete the draft.
 
 ### My Content {#my-content}
 
-On this page, you can see the Marketplace content for which you have created at least one version. 
+On this page, you can see the Marketplace content for which you have created at least one version.
 
-Click the name of the component to go its [component details page](/appstore/component-details/).
+Click the name of the component to access its [details page](/appstore/component-details/).
 
-Click the context menu to access various options for managing your content:
+Click the context menu to access options for managing your content:
 
 {{< figure src="/attachments/appstore/marketplace-home-page/my-content.png"  width="400"  class="no-border" >}}
 
-* **Manage Drafts** – Click this to manage the drafts of the component
-    * Only one draft version of a component can exist at a time, so when one draft version is in progress, another draft cannot be initiated
-    * If there is a draft version in progress, you will see options to **Edit Draft** or **Delete Draft**
-    * If there is a draft version in progress assigned to another user, you will see an option to **Reassign Draft** to yourself 
-    * For more information on creating a draft version, see the [Updating Existing Marketplace Content](/appstore/submit-content/#updating) section of *How to Share Marketplace Content*
-* **Edit a Version** – Click this to edit the component (for details on editing, see the [Adding New Marketplace Content](/appstore/submit-content/#adding) section of *How to Share Marketplace Content*)
-* **Unpublish a Version** – Click this to remove one version or all versions of the component
-    * If the component is [protected content](#group-content) from a [content group](#content-groups), a [group member](#members) can unpublish any version
-    * If the component is not the protected content of a content group, you can only unpublish a version that you have published yourself
-    * Select **Unpublish All My Versions** to remove all your versions of the component
+* **Manage Drafts** – Manage the drafts of the component.
+    * Only one draft version of a component can exist at a time, so when one draft version is in progress, you cannot initiate another.
+    * If there is a draft version in progress, you can edit or delete it.
+    * If there is a draft version in progress, and it is assigned to another user, you can reassign it to to yourself. 
+
+    For more information on creating a draft version, see the [Updating Existing Marketplace Content](/appstore/submit-content/#updating) section of *Upload to the Marketplace*.
+* **Edit a Version** – Edit the component. For details on editing, see the [Adding New Marketplace Content](/appstore/submit-content/#adding) section of *Upload to the Marketplace*.
+* **Unpublish a Version** – Remove one or all versions of the component.
+    * If the component is [protected](#group-content) within a [content group](#content-groups), a [group member](#members) can unpublish any version.
+    * If the component is not protected within a content group, you can only unpublish a version that you have published yourself.
+    * Select **Unpublish All My Versions** to remove all your versions of the component.
 
-You may see the **Private** label on a component, which means it is your company's private Marketplace content (for details on how this is configured, see the [Adding New Marketplace Content](/appstore/submit-content/#private) section of *How to Share Marketplace Content*). This content can be shared with [guests](#guests).
+A **Private** label on a component means the component is your company's private Marketplace content. For details on how this is configured, see the [Adding New Marketplace Content](/appstore/submit-content/#adding) section of *Upload to the Marketplace*. This content can be shared with [guests](#guests).
 
-In addition, you may see a label on a component name for the [content group](#content-groups) to which the component is assigned as group [group content](#group-content).
+A component assigned as [group content](#group-content) will have a label for the [content group](#content-groups) to which it is assigned.
 
 ### Shared with Me {#shared-with-me}
 
@@ -116,45 +110,40 @@ This page contains private content shared with you by other companies who have m
 
 This page presents the Marketplace content you have [saved](/appstore/component-details/). 
 
-Click the name of the component to go its [component details page](/appstore/component-details/).
+Click the name of the component to access its [details page](/appstore/component-details/).
 
-Click the context menu to access various options for managing this content:
+Click the context menu to access options for managing this component:
 
 {{< figure src="/attachments/appstore/marketplace-home-page/saved.png"  width="400"  class="no-border" >}}
 
-* **Receive/Stop Email Notifications** – click this to start receiving email notifications or to stop the notifications if you already have them enabled
-* **Unsave** – click this to remove the component from your saved content
+* **Receive/Stop Email Notifications** – Start receiving email notifications, or stop the notifications if they are enabled.
+* **Unsave** – Remove the component from your saved content.
 
 ### My Reviews {#my-reviews}
 
-This page contains reviews of [My Content](#my-content) by other users as well as **My reviews** that you have written of other content.
+This page contains reviews of [My Content](#my-content) by other users, as well as **My reviews** that you have written for other content.
 
 ## Company {#company}
 
-The **Company** category contains the following items:
-
-* Company Content
-* Content Group
-
-These items are described in the sections below.
+The **Company** category contains the items described in the following sections.
 
 ### Company Content {#company-content}
 
-On this page, you can see all the content your company has published as a private Marketplace.
+On this page, you can see all the content your company has published to the Marketplace as private.
 
-Click the name of the component to go its [component details page](/appstore/component-details/).
+Click the name of the component to access its [details page](/appstore/component-details/).
 
-Click the context menu to access various options for managing this content:
+Click the context menu to access options for managing this content:
 
 {{< figure src="/attachments/appstore/marketplace-home-page/company-content.png"  width="400"  class="no-border" >}}
 
-The options in this menu are the same as described for the context menu for the [My Content](#my-content) section above. However, the **Edit a Version** and **Unpublish a Version** options are only available for your own versions of company content.
+The options in this menu are the same as those for the [My Content](#my-content) section. However, the **Edit a Version** and **Unpublish a Version** options are only available for your own versions of company content.
 
-### Content Groups {#content-groups}
+### Content Group {#content-groups}
 
-The **Content Groups** menu item and page are visible to all users. However, only [Mendix Admins](/control-center/company-settings/) can create and delete content groups. Both [Group Admins](#members) and Mendix Admins can manage content group members. 
+The **Content Group** menu item and page are visible to all users. However, only [Mendix Admins](/control-center/company-settings/) can create and delete content groups. Both [Group Admins](#members) and Mendix Admins can manage content group members. 
 
-You can configure content groups for various levels of access to your company content. The available configuration tabs for each content group page are described in the sections below.
+You can configure content groups for various levels of access to your company content. The available configuration tabs for each content group page are described in the following sections.
 
 This table breaks down the roles and permissions for content groups:
 
@@ -168,19 +157,19 @@ This table breaks down the roles and permissions for content groups:
 
 #### Content Tab {#group-content}
 
-On this tab, you can assign content to this content group that can only be managed by members of this group. To assign a component to a content group, click **Assign Content** and select a company Marketplace component from the dialog box:
+On this tab, you can assign content that can only be managed by members of this group. To assign a component to a content group, click **Assign Content**, and select a Marketplace component from the dialog box:
 
 {{< figure src="/attachments/appstore/marketplace-home-page/group-content.png"  width="400"  class="no-border" >}}
 
 {{% alert color="info" %}}
-A component can only be assigned to one content group at a time. If a component is already assigned to another content group, it will not appear in this dialog box.
+A component can only be assigned to one content group at a time. If a component is already assigned to another content group, it will not be displayed in this dialog box.
 {{% /alert %}}
 
-Click the context menu to access various options for managing this content:
+Click the context menu to access options for managing this content:
 
 {{< figure src="/attachments/appstore/marketplace-home-page/group-content-context.png" width="400" class="no-border" >}}
 
-The options in this menu are the same as described for the context menu for the [My Content](#my-content) section above. The **Unassign from Group** button is only available for [Group Admins](#members) and can be used to remove content from the content group.
+The options in this menu are the same as those for the [My Content](#my-content) section. The **Unassign from Group** button is only available for [Group Admins](#members), and can be used to remove content from the content group.
 
 #### Members Tab {#members}
 
@@ -192,12 +181,14 @@ To remove a member, click **Remove** next to their name.
 
 #### Guests Tab {#guests}
 
-A guest is a Mendix Platform user from outside your organization who can download the selected private [Content](#group-content) of this group. To add a guest, enter their email address in the box and click **Add Guest**:
+A guest is a Mendix Platform user from outside your organization who can download the selected private [content](#group-content) of this group. 
+
+To add a guest, enter their email address in the box and click **Add Guest**. They will receive an email notifying them of access to the private content. 
 
-The guest will receive an email notifying them of access to the private content. They can then see all the private Marketplace content shared with them in their [Shared with Me](#shared-with-me) page.
+The guest can then see all the private Marketplace content shared with them on their [Shared with Me](#shared-with-me) page.
 
 {{% alert color="info" %}}
-The guest must be a registered Mendix Platform user; otherwise, they will not be able to access the shared content.
+The guest must be a registered Mendix Platform user. Otherwise, they will not be able to access the shared content.
 {{% /alert %}}
 
 To remove a guest, click **Remove**.
@@ -216,4 +207,4 @@ To delete a content group, a Group Admin or Mendix Admin can click **Delete Grou
 
 The **Data** category contains the following items:
 
-* Catalog – Clicking it opens [Mendix Catalog](https://catalog.mendix.com/).
+* Catalog – Open the [Mendix Catalog](https://catalog.mendix.com/).