wandb
diff --git a/‎models/reports/clone-and-export-reports.mdx‎
Lines changed: 14 additions & 7 deletions b/‎models/reports/clone-and-export-reports.mdx‎
Lines changed: 14 additions & 7 deletions
diff --git a/‎models/reports/collaborate-on-reports.mdx‎
Lines changed: 20 additions & 12 deletions b/‎models/reports/collaborate-on-reports.mdx‎
Lines changed: 20 additions & 12 deletions
diff --git a/‎models/reports/create-a-report.mdx‎
Lines changed: 17 additions & 16 deletions b/‎models/reports/create-a-report.mdx‎
Lines changed: 17 additions & 16 deletions
diff --git a/‎models/reports/cross-project-reports.mdx‎
Lines changed: 9 additions & 8 deletions b/‎models/reports/cross-project-reports.mdx‎
Lines changed: 9 additions & 8 deletions
@@ -1,30 +1,37 @@
 ---
 description: "Export W&B Reports as PDF or LaTeX files, and clone reports using the App UI or the Report and Workspace API."
 title: Clone and export reports
+keywords: ["export report", "clone report", "PDF", "LaTeX", "Report and Workspace API"]
 ---
 
 <Note>
 W&B Report and Workspace API is in Public Preview.
 </Note>
 
-## Export reports
+This page describes how to export a W&B Report to a portable file format. It also describes how to clone an existing report to reuse its structure as a starting point for new work.
 
-Export a report as a PDF or LaTeX. Within your report, select the **action (<Icon icon="ellipsis-vertical" iconType="solid"/>)** menu to expand the dropdown menu. Choose **Download and** select either PDF or LaTeX output format.
+## Export a report
 
-## Cloning reports
+Export a report as a PDF or LaTeX file to share its contents outside of W&B or to archive a static version of your analysis. In your report, select the **action (<Icon icon="ellipsis-vertical" iconType="solid"/>)** menu. Choose **Download** and select either PDF or LaTeX output format.
+
+## Clone a report
+
+Clone a report to reuse an existing project's template and formatting as the basis for a new report. You can clone reports in the W&B App UI or programmatically with the Report and Workspace API.
 
 <Tabs>
 <Tab title="W&B App">
-Within your report, select the **action (<Icon icon="ellipsis-vertical" iconType="solid"/>)** menu to expand the dropdown menu. Choose the **Clone this report** button. Pick a destination for your cloned report in the modal. Choose **Clone report**.
+In your report, select the **action (<Icon icon="ellipsis-vertical" iconType="solid"/>)** menu. Choose **Clone this report**. In the modal, pick a destination for your cloned report. Choose **Clone report**.
 
 <Frame>
     <img src="/images/reports/clone_reports.gif" alt="Cloning reports"  />
 </Frame>
 
-Clone a report to reuse a project's template and format. Cloned projects are visible to your team if you clone a project within the team's account. Projects cloned within an individual's account are only visible to that user.
+When you clone a report, you specify the destination. If you clone it to a team, all team members can view it. If you clone it to your personal account, only you can view it by default.
 </Tab>
 <Tab title="Report and Workspace API">
-Load a Report from a URL to use it as a template.
+Use the Report and Workspace API to load an existing report from its URL and reuse it as a template for a new report.
+
+Load a report from a URL to use it as a template. Replace `PROJECT` with the name of your W&B project.
 
 ```python
 report = wr.Report(
@@ -34,7 +41,7 @@ report.save()  # Save
 new_report = wr.Report.from_url(report.url)  # Load
 ```
 
-Edit the content within `new_report.blocks`.
+After you load the report, edit the content in `new_report.blocks` to customize the cloned report, then save it. Replace `ENTITY` with your W&B entity name.
 
 ```python
 pg = wr.PanelGrid(
 
@@ -1,36 +1,44 @@
 ---
 description: Collaborate and share W&B Reports with peers, co-workers, and your team.
 title: Collaborate on reports
+keywords: ["share report", "report comments", "star report", "report collaboration", "edit conflict"]
 ---
 
-This page describes various ways to collaborate on reports with your team.
+This page describes ways to collaborate on reports with your team. Use these workflows to share results, gather feedback, and keep important reports accessible.
+
+You can share a report, edit it collaboratively, add comments, or star it for quick access.
 
 ## Share a report
-When viewing a report, click **Share**, then:
-- To share a link to the report with an email address or a username, click **Invite**. Enter an email address or username, select **Can view** or **Can edit**, then click **Invite**. If you share by email, the email address does not need to be a member of your organization or team.
+
+When viewing a report, click **Share**. You can share a report in one of the following ways:
+
+- To share a link to the report with an email address or a username, click **Invite**. Enter an email address or username, select **Can view** or **Can edit**, then click **Invite**. If you share by email, the email address doesn't need to be a member of your organization or team.
 - To generate a sharing link instead, click **Share**. Adjust the permissions for the link, then click **Copy report link**. Share the link with the member.
 
-When viewing the report, click a panel to open it in full-screen mode. If you copy the URL from the browser and share it with another user, when they access the link the panel will open directly in full-screen mode.
+When viewing the report, click a panel to open it in full-screen mode. If you copy the URL from the browser and share it with another user, the panel opens directly in full-screen mode when they access the link.
 
 ## Edit a report
-When any team member clicks the **Edit** button to begin editing the report, a draft is automatically saved. Select **Save to report** to publish your changes.
 
-If an edit conflict occurs, such as when two team members edit the report at once, a warning notification helps you to resolve any conflicts.
+Multiple team members can edit the same report and publish changes when they're ready. When any team member clicks the **Edit** button to begin editing the report, W&B automatically saves a draft. Select **Save to report** to publish your changes.
+
+If an edit conflict occurs, such as when two team members edit the report at once, a warning notification helps you resolve any conflicts.
 
 <Frame>
-    <img src="/images/reports/share-report.gif" alt="Report sharing modal for a report in a  'Public' project" max-width="90%"  />
+    <img src="/images/reports/share-report.gif" alt="Report sharing modal for a report in a 'Public' project" max-width="90%" />
 </Frame>
 
 ## Comment on reports
-Click **Comment** to leave a comment on a report.
 
-To comment directly on a panel, hover over the panel, then click the comment button, which looks like a speech bubble.
+To leave a comment on a report, click **Comment**.
+
+To comment directly on a panel, hover over the panel, then click the comment button (<Icon icon="comment" iconType="regular"/>).
 
 <Frame>
-    <img src="/images/reports/demo_comment_on_panels_in_reports.gif" alt="Adding a comment to a panel"  />
+    <img src="/images/reports/demo_comment_on_panels_in_reports.gif" alt="Adding a comment to a panel" />
 </Frame>
 
 ## Star a report
-If your team has a large number of reports, click **Star** at the top of a report to add it to your favorites. When viewing your team's list of reports, click the star in a report's row to add it to your favorites. Starred reports appear at the top of the list.
 
-From the list of reports, you can see how many members have starred each report to gauge its relative popularity.
+If your team has many reports, click the open star icon (<Icon icon="star" iconType="regular"/>) at the top of a report to add it to your favorites. To remove the star, click the closed star icon (<Icon icon="star" iconType="solid"/>). When viewing your team's list of reports, click the open star in a report's row to add it to your favorites. Starred reports appear at the top of the list.
+
+From the list of reports, you can see how many members have starred each report to gauge its popularity.
@@ -1,41 +1,42 @@
 ---
 description: Create a W&B Report with the W&B App or programmatically.
 title: Create a report
+keywords: ["create report", "wandb-workspaces", "Report API", "programmatic reports"]
 ---
 
 <Note>
 W&B Report and Workspace API is in Public Preview.
 </Note>
 
-Select a tab below to learn how to create a report in the W&B App or programmatically with the W&B Report and Workspace API.
+Select a tab to learn how to create a report in the W&B App or programmatically with the Report and Workspace API.
 
-See this [Google Colab](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Report_API_Quickstart.ipynb) for an example on how to programmatically create a report.
+For an example of how to programmatically create a report, see this [Google Colab](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Report_API_Quickstart.ipynb).
 
 
 <Tabs>
 <Tab title="W&B App">
 1. Navigate to your project workspace in the W&B App.
-2. Click **Create report** in the upper right corner of your workspace.
+2. In the upper-right corner of your workspace, click **Create report**.
 
     <Frame>
-    <img src="/images/reports/create_a_report_button.png" alt="Create report button"  />
+    <img src="/images/reports/create_a_report_button.png" alt="Create report button" />
     </Frame>
 
-3. A modal will appear. Select the charts you would like to start with. You can add or delete charts later from the report interface.
+3. A modal appears. Select the charts you want to start with. You can add or delete charts later from the report interface.
 
     <Frame>
-    <img src="/images/reports/create_a_report_modal.png" alt="Create report modal"  />
+    <img src="/images/reports/create_a_report_modal.png" alt="Create report modal" />
     </Frame>
 
-4. Select the **Filter run sets** option to prevent new runs from being added to your report. You can toggle this option on or off. Once you click **Create report,** a draft report will be available in the report tab to continue working on.
+4. Select the **Filter run sets** option to prevent new runs from being added to your report. You can toggle this option on or off. A draft report is saved automatically. Access it in the **Reports** tab.
 </Tab>
 <Tab title="Report tab">
 1. Navigate to your project workspace in the W&B App.
-2. Select to the **Reports** tab (clipboard image) in your project.
-3. Select the **Create Report** button on the report page. 
+2. Select the **Reports** tab in your project.
+3. Click **Create report**.
 
     <Frame>
-    <img src="/images/reports/create_report_button.png" alt="Create report button"  />
+    <img src="/images/reports/create_report_button.png" alt="Create report button" />
     </Frame>
 </Tab>
 <Tab title="Report and Workspace API">
@@ -45,21 +46,21 @@ Create a report programmatically:
     ```bash
     pip install wandb wandb-workspaces
     ```
-2. Next, import workspaces
+2. Import the W&B Python SDK and the Report and Workspace API.
     ```python
     import wandb
     import wandb_workspaces.reports.v2 as wr
-    ```       
-3. Create a report with `wandb_workspaces.reports.v2.Report`. Create a report instance with the Report Class Public API ([`wandb.apis.reports`](/models/ref/python/public-api/api#reports)). Specify a name for the project.   
+    ```
+3. Create a report with `wandb_workspaces.reports.v2.Report`. Create a report instance with the Report Class Public API ([`wandb.apis.reports`](/models/ref/python/public-api/api#reports)). Specify a name for the project.
     ```python
     report = wr.Report(project="report_standard")
-    ```  
+    ```
 
-4. Save the report. Reports are not uploaded to the W&B server until you call the .`save()` method:
+4. Save the report. Reports aren't uploaded to W&B until you call the `.save()` method:
     ```python
     report.save()
     ```
 
-For information on how to edit a report interactively with the App UI or programmatically, see [Edit a report](/models/reports/edit-a-report/).
+For more information, see [Edit a report](/models/reports/edit-a-report).
 </Tab>
 </Tabs>
@@ -1,40 +1,41 @@
 ---
 description: Compare runs from two different projects with cross-project reports.
 title: Compare runs across projects
+keywords: ["magic link", "view-only report", "run set", "share report", "project selector"]
 ---
 <Note>
 Watch a [video demonstrating comparing runs across projects](https://www.youtube.com/watch?v=uD4if_nGrs4) (2 min).
 </Note>
 
 
-Compare runs from two different projects with cross-project reports. Use the project selector in the run set table to pick a project.
+Cross-project reports let you compare runs from two different projects side by side, which is useful when you want to evaluate experiments tracked under separate W&B projects without duplicating data. Use the project selector in the run set table to pick a project.
 
 <Frame>
     <img src="/images/reports/howto_pick_a_different_project_to_draw_runs_from.gif" alt="Compare runs across different projects"  />
 </Frame>
 
-The visualizations in the section pull columns from the first active runset. Make sure that the first run set checked in the section has that column available if you do not see the metric you are looking for in the line plot.
+The visualizations in the section pull columns from the first active run set. If you don't see the metric you're looking for in the line plot, make sure that the first run set checked in the section has that column available.
 
-This feature supports history data on time series lines, but we don't support pulling different summary metrics from different projects. In other words, you can not create a scatter plot from columns that are only logged in another project.
+This feature supports history data on time series lines, but doesn't support pulling different summary metrics from different projects. In other words, you can't create a scatter plot from columns that are only logged in another project.
 
-If you need to compare runs from two projects and the columns are not working, add a tag to the runs in one project and then move those runs to the other project. You can still filter only the runs from each project, but the report includes all the columns for both sets of runs.
+If you need to compare runs from two projects and the columns aren't working, add a tag to the runs in one project and then move those runs to the other project. You can still filter only the runs from each project, but the report includes all the columns for both sets of runs.
 
 ## View-only report links
 
-Share a view-only link to a report that is in a private project or team project.
+When you need to share a report with someone outside your project (such as a stakeholder who doesn't have a W&B account), use a view-only link. Share a view-only link to a report that is in a private project or team project.
 
 <Frame>
     <img src="/images/reports/magic-links.gif" alt="View-only report links"  />
 </Frame>
 
 View-only report links add a secret access token to the URL, so anyone who opens the link can view the page. Anyone can use the magic link to view the report without logging in first. For customers on [W&B Local](/platform/hosting/) private cloud installations, these links remain behind your firewall, so only members of your team with access to your private instance _and_ access to the view-only link can view the report.
 
-In **view-only mode**, someone who is not logged in can see the charts and mouse over to see tooltips of values, zoom in and out on charts, and scroll through columns in the table. When in view mode, they cannot create new charts or new table queries to explore the data. View-only visitors to the report link won't be able to click a run to get to the run page. Also, the view-only visitors would not be able to see the share modal but instead would see a tooltip on hover which says: `Sharing not available for view only access`.
+In **view-only mode**, someone who isn't logged in can see the charts and mouse over to see tooltips of values, zoom in and out on charts, and scroll through columns in the table. When in view mode, they can't create new charts or new table queries to explore the data. View-only visitors to the report link can't click a run to get to the run page. Also, view-only visitors can't see the share modal. Instead, they see a tooltip on hover that says: `Sharing not available for view only access`.
 
 <Info>
-The magic links are only available for “Private” and “Team” projects. For “Public” (anyone can view) or “Open” (anyone can view and contribute runs) projects, the links can't turn on/off because this project is public implying that it is already available to anyone with the link.
+The magic links are only available for "Private" and "Team" projects. For "Public" (anyone can view) or "Open" (anyone can view and contribute runs) projects, you can't turn the links on or off because the project is public, meaning it's already available to anyone with the link.
 </Info>
 
 ## Send a graph to a report
 
-Send a graph from your workspace to a report to keep track of your progress. Click the dropdown menu on the chart or panel you'd like to copy to a report and click **Add to report** to select the destination report.
+If you want to preserve a chart from a workspace alongside related analysis, you can send it directly to a report. Send a graph from your workspace to a report to keep track of your progress. Click the dropdown menu on the chart or panel you'd like to copy to a report and click **Add to report** to select the destination report.