Adapted text around screenshots

NicoletaComan · NicoletaComan · commit dd1cde6cc1e5 · 2025-09-16T17:02:21.000+02:00
diff --git a/content/en/docs/developerportal/general/documents.md b/content/en/docs/developerportal/general/documents.md
@@ -30,7 +30,7 @@ To download a document, click **Download** ({{% icon name="download-bottom" %}})
 
 ### Viewing the Details
 
-Click **Show Details** for a document to see the description of the file, comments, and all the versions of the document:
+Click **Show Details** for a document to see the description of the file, comments, and all the versions of the document.
 
 {{< figure src="/attachments/developerportal/general/documents/document-details.png" class="no-border" >}}
 
diff --git a/content/en/docs/developerportal/general/overview.md b/content/en/docs/developerportal/general/overview.md
@@ -14,7 +14,7 @@ Located in the [navigation pane](/developerportal/#navigation-pane) of **Apps**,
 
 {{< figure src="/attachments/developerportal/general/overview/project-overview.png" >}}
 
-At the top of the page, you will find key information about your app, such as its logo, name, and description. If no description is provided, there is a placeholder text. With the **App Settings** permission, you can change the logo, name, and description of the app on the [Settings](/developerportal/collaborate/general-settings/) page.
+At the top of the page, you can find key information about your app, such as its logo, name, and description. If no description is provided, there is a placeholder text. With the **App Settings** permission, you can change the logo, name, and description of the app on the [Settings](/developerportal/collaborate/general-settings/) page.
 
 On the right side of the page, you can find the following information about your app:
 
diff --git a/content/en/docs/developerportal/general/settings/_index.md b/content/en/docs/developerportal/general/settings/_index.md
@@ -37,15 +37,13 @@ The page header displays the following information:
 * The company that owns the app.
 * The **Watch** / **Stop Watching** toggle – You can enable or disable notifications for this app.
 
-{{< figure src="/attachments/developerportal/general/settings/general-information.png"  class="no-border" >}}
-
 {{% alert color="info" %}}
 Only users with the **App Settings** permission can edit the image and the app name.
 {{% /alert %}}
 
 ## General {#general}
 
-In this tab, you can find the following items:
+On this tab, you can find the following items:
 
 * Logo of the project
 * **Description** of the project
diff --git a/content/en/docs/developerportal/general/team/app-roles.md b/content/en/docs/developerportal/general/team/app-roles.md
@@ -40,7 +40,7 @@ Mendix Admins can edit and create new team roles within the company in [Control
 
 ## Technical Contact {#technical-contact}
 
-Every deployed app has a Technical Contact. When you view the [Settings](/developerportal/collaborate/general-settings/#general) for a deployed app, you can see the app's Technical Contact. The Technical Contact is the user you can contact with questions related to the app. 
+Every deployed app has a Technical Contact. When you view the [Settings](/developerportal/collaborate/general-settings/#general) for a deployed app, you can see the app's Technical Contact. The Technical Contact is the user you can get in touch with for questions related to the app. 
 
 {{< figure src="/attachments/developerportal/general/team/app-roles/technical-contact.png" alt="" class="no-border" >}}
 
diff --git a/content/en/docs/developerportal/project-management/epics/archive.md b/content/en/docs/developerportal/project-management/epics/archive.md
@@ -26,7 +26,7 @@ The **Archive** page shows all the archived stories.
 * Linked epic – Clicking this shows the epic details.
 * Archive date and time – Clicking this shows the story details.
 
-If a feedback item was linked to your archived story, you will see it with a purple icon:
+If a feedback item was linked to your archived story, it is accompanied by a purple icon.
 
 {{< figure src="/attachments/developerportal/project-management/epics/archive/archive.png" class="no-border" >}}
 
diff --git a/content/en/docs/developerportal/project-management/epics/board.md b/content/en/docs/developerportal/project-management/epics/board.md
@@ -59,7 +59,7 @@ You can move a swimlane by dragging it to the new location.
 
 ### Story Cards {#story-card}
 
-Each card in a swimlane represents a story:
+Each card in a swimlane represents a story.
 
 {{< figure src="/attachments/developerportal/project-management/epics/board/story-card.png" class="no-border" >}}
 
@@ -75,7 +75,7 @@ A story card shows the following details:
 * ⑧ Points of the story
 * ⑨ To whom the story is assigned
 
-You can [archive](/developerportal/project-management/epics/archive/) or delete a story as follows: click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) on the upper-right corner of the card, and then select the corresponding option:
+You can [archive](/developerportal/project-management/epics/archive/) or delete a story by clicking **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) in the upper-right corner of the card, then selecting the corresponding option.
 
 {{< figure src="/attachments/developerportal/project-management/epics/board/archive-delete-story.png" class="no-border" >}}
 
diff --git a/content/en/docs/developerportal/project-management/epics/epics.md b/content/en/docs/developerportal/project-management/epics/epics.md
@@ -35,7 +35,7 @@ In the upper-right corner, there is a **Copy Link** icon ({{% icon name="hyperli
 
 The epic details dialog box shows the following items:
 
-* **Objective** – This is the description of the epic:
+* **Objective** – This is the description of the epic.
     * You can edit the objective of the epic by clicking **Edit Objective** and making changes in the WYSIWYG editor. The editor supports different text formats, including code blocks
     * You can link a story in the editor by typing *#* and the story title, and then selecting the right story from the list.
     * You can type a person in the editor by typing *@* and the person's name, and then selecting the right person from the list. Once you save the epic, the system will send a notification to the tagged person.
diff --git a/content/en/docs/developerportal/project-management/epics/planning.md b/content/en/docs/developerportal/project-management/epics/planning.md
@@ -9,7 +9,7 @@ description: "Describes the Planning page in Epics. This page looks different, d
 
 The **Planning** page shows all your stories.
 
-The main area of the **Planning** page lists all the stories in different categories. Each row represents a story:
+The main area of the **Planning** page lists all the stories in different categories. Each row represents a story.
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/story-kanban.png" class="no-border" >}}
 
@@ -74,7 +74,7 @@ To move multiple stories, select these stories, choose the category name where t
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/move-multiple-stories.png" class="no-border" >}}
 
-To [archive](/developerportal/project-management/epics/archive/) or delete a story, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) at the end of the row, then select the corresponding option:
+To [archive](/developerportal/project-management/epics/archive/) or delete a story, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) at the end of the row, then select the corresponding option.
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/archive-delete-story-kanban.png" class="no-border" >}}
 
@@ -101,7 +101,8 @@ The **Planning** page offers different features to accommodate two different wor
 
 If your board style is Scrum, you can find the features below which accommodate your Scrum workflow.
 
-If there is an active Sprint, on the upper-left corner, you can find the name of the Sprint, when it ends, and how many stories and points it has. If you hover over the goal icon, you can see the goal of the Sprint:
+If there is an active Sprint, in the upper-left corner, you can find the name of the Sprint, when it ends, and how many stories and points it has.     
+If you hover over the goal icon, you can see the goal of the Sprint.
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/scrum-planning.png" class="no-border" >}}
 
@@ -118,18 +119,16 @@ On the upper-right corner, you can find these Scrum items if you click **More Op
 
 ### Kanban Planning {#kanban-planning}
 
-If your board type is Kanban, the stories are grouped in these categories: **To Do**, **Refinement**, and **Backlog**. At the top of each category, you can see the total number of stories and points.
+If your board type is Kanban, the stories are grouped in these categories: **To Do**, **Refinement**, and **Backlog**.     
+At the top of each category, you can see the total number of stories and points.
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/kanban-planning.png" class="no-border" >}}
 
 ## Importing Stories {#import-stories}
 
 You can import your stories using an Excel file to Epics as follows:
 
-1. In the upper-right corner of the **Planning** page, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) and then click **Import Stories**.
-
-   {{< figure src="/attachments/developerportal/project-management/epics/planning/import-stories.png" class="no-border" >}}
-
+1. In the upper-right corner of the **Planning** page, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}), then click **Import Stories**.    
    The **Import Stories From Excel** dialog box opens.
 
 2. Click **Download** to download the Excel file template.
@@ -172,9 +171,7 @@ You can find all the imported stories in the **Backlog**.
 
 You can export your stories on the **Planning** page to an Excel file as follows:
 
-1. On the upper-right corner of the **Planning** page, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}), then click **Export Stories**.
-
-   {{< figure src="/attachments/developerportal/project-management/epics/planning/export-stories.png" class="no-border" >}}
+1. In the upper-right corner of the **Planning** page, click **More Options** ({{% icon name="three-dots-menu-horizontal" %}}), then click **Export Stories**.
 2. Select where you want to export stories from.
 3. Click **Continue** to see a preview of the Excel file.
 4. Click **Export to Excel**.
@@ -209,6 +206,6 @@ On this tab, you can switch between a Scrum workflow and Kanban workflow. The wo
 
 ### Toast Settings
 
-On this tab, you can enable or disable the toast notifications that appear like this:
+On this tab, you can enable or disable the toast notifications that are displayed along the screen.
 
 {{< figure src="/attachments/developerportal/project-management/epics/planning/toast-notification.png" width="500px" class="no-border" >}}
diff --git a/content/en/docs/developerportal/project-management/jira-connector.md b/content/en/docs/developerportal/project-management/jira-connector.md
@@ -51,11 +51,8 @@ To connect your app to Jira, perform the following steps:
 
 3. Go to the **Project Management** tab.
 
-4. Click **Connect Jira**. The **Set Up Jira Configuration** dialog box opens.
-
-    {{< figure src="/attachments/developerportal/project-management/jira-connector/set-up-jira-configuration.png"   class="no-border" >}}
-
-    Fill in the information as follows:
+4. Click **Connect Jira**. The **Set Up Jira Configuration** dialog box opens.    
+   Fill in the information as follows:
 
     * **URL Jira Environment**: This is the URL of your company’s environment within the Jira platform, as provided by Jira. This URL usually looks like this: `https://my-company.atlassian.net`.
     * **Project Key**: This is the unique key of your project within the Jira platform.
@@ -66,8 +63,6 @@ To connect your app to Jira, perform the following steps:
 
 6. If your Jira project has several boards configured, from the drop-down list, select one of the Jira boards to connect. We support the Scrum, simplified Scrum, and Kanban board types.
 
-    {{< figure src="/attachments/developerportal/project-management/jira-connector/connect-jira-board.png" >}}
-
 7. Click **Activate** to activate the connection. 
 
 Once the activation is completed, your app is connected to Jira. You can see the following:
@@ -86,7 +81,7 @@ Once the activation is completed, your app is connected to Jira. You can see the
 
     {{< figure src="/attachments/developerportal/project-management/jira-connector/navigation-jira.png" >}}
 
-## View Settings
+## Viewing Settings
 
 After you activated the Jira connector, you can review the configuration details any time.
 
diff --git a/content/en/docs/mendix-portal/global-navigation.md b/content/en/docs/mendix-portal/global-navigation.md
@@ -13,7 +13,7 @@ The global navigation top bar and menu are available throughout Mendix Portal, a
 
 ## Global Navigation Menu {#global-navigation}
 
-On the left side of the top bar, click **Open Global Navigation** ({{% icon name="layout-rounded-1" %}}) to access the main menu:
+On the left side of the top bar, click **Open Global Navigation** ({{% icon name="layout-rounded-1" %}}) to access the main menu.
 
 {{< figure src="/attachments/developerportal/global-nav/navigation-menu.png" width="250" class="no-border" >}}
 
@@ -23,7 +23,7 @@ Click the menu items to navigate to different parts of Mendix Portal, or hover o
 
 In the **Search** box, you can search the portal for **Docs**, **Forum** posts, public **Marketplace** content, and **Academy** content.
 
-Use the various filters to refine your search results:
+Use the various filters to refine your search results.
 
 {{< figure src="/attachments/mendix-portal/global-nav/portal_search.png" class="no-border" >}}
 
diff --git a/content/en/docs/mendix-portal/mendix-profile/_index.md b/content/en/docs/mendix-portal/mendix-profile/_index.md
@@ -78,7 +78,7 @@ When you complete a challenge, click **Claim Credits** to claim your Mendix cred
 
 ## Connections {#connections}
 
-One of the greatest strengths of Mendix is our awesome developers community, and the **Connections** card is the perfect place to start connecting to other Mendix developers. When you get an invitation to connect, you can check out their profile and decide whether to accept or ignore it. 
+One of the greatest strengths of Mendix is our developer community, and the **Connections** card is the perfect place to start connecting to other Mendix developers. When you get an invitation to connect, you can check out their profile and decide whether to accept or ignore it. 
 
 You can also see a list of people you may know, so that you can add further connections to your profile. To connect with someone, click the plus icon to send an invitation.
 
