docs: update users and roles article

portal/get-started-portal.md

@@ -1,12 +1,12 @@
 ---
-title: First Steps  
+title: First Steps with the Portal
 description: "Open the customer link in the Fiddler Jam Portal cloud and learn how to access protected workspaces with stored logs, add context, and share submitted logs with the team."
 slug: first_steps_portal
 publish: true
-position: 2
+position: 1
 ---
 
-# First Steps with Fiddler Jam Portal
+# First Steps with the Fiddler Jam Portal
 
 This tutorial describes how to install and start using the Fiddler Jam Portal if you have access rights corresponding to the Portal user role.
 
@@ -34,3 +34,12 @@ This tutorial describes how to install and start using the Fiddler Jam Portal if
 
 
 ## Sharing the Log
+
+
+
+## Next Steps
+
+* [Portal Users and Roles]({% slug fj-users %})
+* [Managing Portal Workspaces]({% slug fj-workspaces %})
+* [Working with Submitted Logs]({% slug fj-portal-logs %})
+* [Performing Advanced Log Analyses]({% slug fj-advanced-analysis %})

portal/users.md

@@ -1,6 +1,6 @@
 ---
-title: Users & Roles
-description: Fiddler Jam extensions users, portal users and portal viewers
+title: Users and Roles
+description: "Learn more about the available users and role access permission in the Fiddler Jam Portal cloud space."
 slug: fj-users
 publish: true
 position: 20
@@ -8,47 +8,55 @@ position: 20
 
 # Fiddler Jam Portal Users and Roles
 
-The Chrome extension users are referred to as an **extension users**. The Fiddler Jam portal provides different subscription plans with limited seats for the [**user** role](#user-role) and unlimited seats for the [**viewer** role](#viewer-role). The [account owner](#account-owner) is the user that purchased the Fiddler Jam license and the one who manages the seats.
-
-## Portal Users
-
-The Fiddler Jam login accepts using custom credentials or Google authentication, but the portal will be accessible only for usernames/emails that are part of an active subscription. Depending on the user assigned role, the Fiddler Jam portal will provide a different level of accessibility and features as follows:
-
-- Unregistered users won't be able to open the Fiddler Jam portal or load generated Fiddler Jam links. Note that no registration is needed to use the Fiddler Jam Chrome extension.
-- Fiddler Jam portal seats with the **viewer** role can see only logs [added to a workspace]({%slug fj-workspaces%}#add-submitted-log-to-workspace). If a viewer opens a public link, a page will inform the user that the links need to be added to the account workspace.
-- Fiddler Jam portal seats with the **user** role can open public logs, create and manage workspaces, manage existing logs (manage, add and remove from workspaces).
-
-## Extension Users
-
-Everyone who uses the Fiddler Jam Chrome extension can be described as an extension user. All extension users can capture and record logs and generate Fiddler Jam portal links where the logs will be stored.
-- There is no limitation on the number of recorded logs.
-- There is no limitation for the number of generated links to recorded logs.
-- A recorded log with a generated link will be stored in the Fiddler Jam portal for **30 days.** After that period, the log is automatically deleted.
-- A recorded log with a generated link **that is added to a workspace** by a portal [**user**](#user-role) will be stored in the Fiddler Jam portal until a portal user explicitly removes it.
+The number of users who access the Fiddler Jam Portal depends on the active subscription plan. The person who purchased that plan, the Account Owner, assigns different levels of access rights to different users depending on the role they fulfil.  
 
 ## Account Owner
 
-The account owner is the user who purchased the Fiddler Jam license from [the Fiddler dashboard](https://dashboard.getfiddler.com/). This role manages the subscription seats, payment, and assigning the **user** and the **viewer** roles. Depending on the subscription plan, each license will provide a different number of seats with the **user** role and unlimited seats for the **viewer** role. Manage the seats and their roles through [the Fiddler dashboard](https://dashboard.getfiddler.com).
+The account owner is the user who purchased the Fiddler Jam license from [the Fiddler dashboard](https://dashboard.getfiddler.com/). From the dashboard, the Account Owner can manage the subscription seats, payment, and the assigning of the user and the viewer roles.
+
+Depending on the subscription plan, each license provides a different number of seats. For example, the Fiddler Jam Portal provides limited seats for the [user role](#user-role) and unlimited seats for the [viewer role](#viewer-role).
+
+## Extension Users
+
+Fiddler Jam refers to the end users, who have recorded and submitted logs through the [Fiddler Jam Chrome Extension]({% slug introduction %}#fiffler-jam-chrome-extension), as "extension users".
+
+All extension users can capture and record logs, and generate Fiddler Jam Portal links where the logs will be stored.
+
+- Extension users are not limited on the number of recorded logs.
+- Extension users are not limited on the number of generated links to recorded logs.
+- A recorded log with a generated link will be stored in the Fiddler Jam Portal for 30 days. After that period, the log is automatically deleted.
+- A recorded log with a generated link that is added to a workspace by a [Portal user](#user-role) will be stored in the Fiddler Jam Portal until a Portal user explicitly removes it.
+
+## Portal Users
+
+Even though the Fiddler Jam login accepts custom credentials or Google authentication, the Portal is accessible for users with usernames or emails, which are part of an active subscription only. These users are referred to as "Portal users".
+
+Depending on the user assigned role, the Fiddler Jam portal provides different access levels:
+
+- Unregistered users won't be able to open the Fiddler Jam Portal or load generated Fiddler Jam links.
+- Fiddler Jam Portal seats with the viewer role can only watch logs that are [added to a workspace]({%slug fj-workspaces%}#add-submitted-log-to-workspace). If a viewer opens a public link, the page that will open will inform the user that the links need to be added to the account workspace.
+- Fiddler Jam Portal seats with the user role can open public logs, create and manage workspaces, and manage, add, and remove logs from workspaces.
 
 ## User Role
 
-Depending on the chosen Fiddler Jam [subscription plan]({%slug fj-portal%}#subscriptions), the account owner can assign a different number of seats with the **user** role. A portal user can view and maintain **submitted logs** and **workspaces logs** based on the Fiddler Jam account quota. A portal user has full access to the Fiddler Jam dashboard functionalities as opposed to the portal viewer, which has limited rights and can only open **submitted logs** added to a workspace.
+Depending on the active Fiddler Jam [subscription plan]({%slug fj-portal%}#subscriptions), the Account Owner assigns a different number of seats to the User role.
 
-The portal users' seat comes with the following advantages and limitations:
+A User can view and maintain submitted logs and workspace logs based on the Fiddler Jam account quota. Users have full access to the Fiddler Jam dashboard functionalities as opposed to Viewers who have limited rights and can only open submitted logs added to a workspace.
 
-- The portal user can access all logs that are added to the account workspace. Password-protected logs can only be accessed from users with knowledge of the password.
-- The portal user can access logs not added to a workspace.
-- The portal user can edit and remove logs added to the workspace.
-- The portal user can add shared logs to a workspace. Logs added to a workspace will be accessible to all viewers.
-- Logs [shared with specific people]({%slug fj-link-options%}#share-with-specific-people) (based on the registered email) can be accessed from all users with access to the workspace.
+The User seat comes with the following advantages and limitations:
 
+- Users can access all logs that are added to the account workspace. Password-protected logs can only be accessed from users who know the password.
+- Users can access logs that are not added to a workspace.
+- Users can edit and remove logs that are added to the workspace.
+- Users can add shared logs to a workspace. Logs added to a workspace will be accessible to all Viewers.
+- Logs [shared with specific people (based on the registered email)]({%slug fj-link-options%}#share-with-specific-people) can be accessed from all Portal users with access to the workspace.
 
 ## Viewer Role
 
-All subscription plans are coming with unlimited seats for the **viewer** role. Assign a portal viewer to an existing account through [the Fiddler dashboard](https://dashboard.getfiddler.com).
+All subscription plans provide unlimited seats for the Viewer role.
 
-The portal viewer seat comes with the following advantages and limitations:
+The Viewer seat comes with the following advantages and limitations:
 
-- The portal viewer can access all logs that are added to the organization's workspace. Password-protected logs can only be accessed from a viewer with the knowledge of the password.
-- The portal viewer can't access logs not added to a workspace.
-- The portal viewer can't edit and remove logs added to the workspace.
+- Viewers can access all logs that are added to the workspace of the organization. Password-protected logs can only be accessed from a Viewer who knows the password.
+- Viewers can't access logs that are not added to a workspace.
+- Viewers can't edit and remove logs that are added to the workspace.