tkislan · Oct 21, 2026 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026
@@ -5,7 +5,7 @@ noIndex: false
 noContent: false
 ---
 
-We all love a good bar chart or a scatter plot — they're great for deep dives into data. But sometimes, you need to cut to the chase and highlight a single, crucial metric for your stakeholders. That's where our big number chart comes in. It's the simplest way to put your most essential numbers front and center in your apps and dashboards.
+Use a big number block to display one metric in a notebook, app, or dashboard.
 
 ![CleanShot 2024-09-17 at 13.18.26@2x.png](../assets/docs/jrloPDWaTkSYpdCk3lfq.webp)
 
@@ -27,7 +27,7 @@ The big number chart has different formatting options, including:
 
 ## Comparisons
 
-If you want to show progress or change over time, you can also add a comparison to visualize how this number differs from a previous value, making trends instantly noticeable.
+Add a comparison to show how the metric differs from a previous value.
 
 There are a few different ways to do the comparison:
 

@@ -37,7 +37,7 @@ To set up authentication to BigQuery via OAuth, navigate to the [Google Cloud co
 7. Click **Create**
 8. From the newly created Client, copy `CLIENT_ID` and `CLIENT_SECRET`
 
-👉 Now head back to Deepnote and add the Client ID, Client Secret, and Project ID to the Google Big Query integration pop up. You will of course need to make sure you've selected Google OAuth as the authentication method.
+Now head back to Deepnote and add the Client ID, Client Secret, and Project ID to the Google Big Query integration pop up. You will of course need to make sure you've selected Google OAuth as the authentication method.
 ![gbq_oauth_fill.png](../assets/docs/nStDWWqlQgGp73sYYZ6Y.webp)
 
 ### Querying data with user-specific authentication
@@ -54,5 +54,5 @@ When you create an app from a notebook that uses the integration, every app user
 
 <Callout status="info">
 - User authentication is also required to browse the BigQuery schema.
-- Scheduled notebooks can use a BigQuery OAuth integration: scheduled runs authenticate with the OAuth tokens of the user who set up the schedule. Because those tokens can expire or be revoked, scheduled runs may fail unexpectedly — for reliable scheduling, use [service account authentication](google-bigquery#authenticating-with-a-service-account) instead.
+- Scheduled notebooks can use a BigQuery OAuth integration: scheduled runs authenticate with the OAuth tokens of the user who set up the schedule. Those tokens can expire or be revoked. For reliable scheduling, use [service account authentication](google-bigquery#authenticating-with-a-service-account) instead.
 </Callout>
@@ -25,12 +25,12 @@ If you need to make sure to stay in your budget, you can choose to disable the p
 - Stop any running projects with stronger machine settings, and change them to use Basic machines on the next start
 - Disable the options for pay-as-you-go machines in the project settings
 
-Be careful – enabling the option may interrupt the work of your colleagues.
+Be careful because enabling the option may interrupt your colleagues' work.
 
 ### Setting billing limits
 
 If you want to set a limit for your charges, we recommend you set a billing alert for that amount. When you receive the notification, you can follow the link the email and disable the pay-as-you-go machines in your workspace.
 
 ## AI usage limits
 
-AI usage is billed on a usage basis. Each plan includes a monthly AI quota, and usage beyond it is billed as pay-as-you-go. To keep AI spending predictable, workspace admins can set a custom monthly overage limit in the workspace settings, and will receive emails as usage approaches or exceeds the included quota. Admins can also review AI usage — token consumption and cost per user and across the workspace — in the workspace settings.
+AI usage is billed on a usage basis. Each plan includes a monthly AI quota, and usage beyond it is billed as pay-as-you-go. To keep AI spending predictable, workspace admins can set a custom monthly overage limit in the workspace settings, and will receive emails as usage approaches or exceeds the included quota. Admins can also review token consumption and cost per user or across the workspace in the workspace settings.
@@ -57,11 +57,11 @@ Depending on chart type and data type, there are couple of additional settings t
 
 Depending on the chart type, you might be able to manually change the data type of selected column. Deepnote supports 3 data types.
 
-- Nominal — categorical data without a specific order among values. For example, product categories in sales report.
+- Nominal: Categorical data without a specific order among values. For example, product categories in a sales report.
 
-- Temporal — data related to time and dates. Following our sales report example, order date will have temporal data type.
+- Temporal: Data related to time and dates. In the sales report example, the order date has a temporal data type.
 
-- Quantitative — numerical data that can be measured and analyzed mathematically, e.g. product prices or store's revenue.
+- Quantitative: Numerical data that you can measure and analyze mathematically, e.g. product prices or store revenue.
 
 ### Aggregation
 
@@ -111,7 +111,7 @@ You can also apply **conditional filters** on your charts, giving you more preci
 
 <VideoLoop src="../assets/docs/p7WogC9QmqIYj1exF9VQ.mp4" />
 
-Applied filters are always added to the Filters list, making them easy to remove or modify. You can also combine multiple conditional filters — just press the plus button in the Filters list to add a new filter for more complex filtering logic.
+Applied filters appear in the Filters list, where you can remove or modify them. To combine conditional filters, press the plus button in the Filters list and add another filter.
 
 <VideoLoop src="../assets/docs/oQd8gnR22ohfu3Q2hBqw.mp4" />
 
@@ -131,7 +131,7 @@ In addition to all the usual series settings, you can switch series type. Click
 
 ## Custom tooltips
 
-Ever needed to show just a bit more information on a chart without cluttering the entire visualization? With custom tooltips you can enrich your charts by selecting additional columns from your plotted DataFrame to display in the tooltip — not just those configured on the chart.
+Custom tooltips can show more information without adding it to the chart. Select other columns from the plotted DataFrame to display in the tooltip.
 
 It’s perfect for highlighting more information for an unusual data point on a scatterplot or adding context with an extra metric on your bar charts, all without overwhelming your audience.
 

@@ -6,7 +6,7 @@ noContent: false
 
 [Anaconda Inc.](https://www.anaconda.com/) maintains a repository of thousands of curated packages for data science.
 
-Deepnote comes with a pre-built conda environment which allows users to instantly take advantage of the Anaconda ecosystem. This includes being able to use conda—a widely used CLI tool for package management which will include packages from the [Miniconda Installer](https://docs.conda.io/en/latest/miniconda.html).
+Deepnote comes with a pre-built conda environment. You can use conda, a command-line tool for package management, with packages from the [Miniconda Installer](https://docs.conda.io/en/latest/miniconda.html).
 
 ## How to use the conda environment Deepnote
 

@@ -1,6 +1,6 @@
 ---
 title: Converting notebooks to and from Deepnote format
-description: Learn how to convert between Deepnote project files (`.deepnote`) and other notebook formats — Jupyter (`.ipynb`), Quarto (`.qmd`), Percent (`.py`), and Marimo (`.py`) — using the `@deepnote/convert` tool.
+description: Learn how to use the `@deepnote/convert` tool to convert between Deepnote project files (`.deepnote`) and Jupyter (`.ipynb`), Quarto (`.qmd`), Percent (`.py`), or Marimo (`.py`) notebooks.
 noIndex: false
 noContent: false
 ---
@@ -32,7 +32,7 @@ After converting your notebooks, you can open them either in Deepnote or directl
 Option 1: Open directly in [Deepnote](https://deepnote.com)
 
 1. Load the `.deepnote` file in the Deepnote application.
-2. Configure the environment — install required Python packages and set environment variables.
+2. Configure the environment by installing required Python packages and setting environment variables.
 3. Run the notebook in Deepnote Cloud to collaborate in real time, build data apps, and enhance your workflow with AI tools.
 
 Option 2: Open in your IDE
@@ -52,7 +52,7 @@ Option 2: Open in your IDE
 
 ## CLI usage
 
-The package provides a `deepnote-convert` command-line tool for converting notebooks. Pass any supported file as the `<path>` argument — the tool detects the input format automatically (`.ipynb`, `.qmd`, or a `.py` file in Percent or Marimo format) and produces a `.deepnote` file. Pass a `.deepnote` file to convert in the reverse direction (see [Converting .deepnote to other formats](#converting-deepnote-to-other-formats)).
+The package provides a `deepnote-convert` command-line tool for converting notebooks. Pass any supported file as the `<path>` argument. The tool detects the input format (`.ipynb`, `.qmd`, or a `.py` file in Percent or Marimo format) and produces a `.deepnote` file. Pass a `.deepnote` file to convert in the reverse direction (see [Converting .deepnote to other formats](#converting-deepnote-to-other-formats)).
 
 ### Convert a single notebook
 
@@ -62,7 +62,7 @@ Convert a single `.ipynb` file to a `.deepnote` file:
 deepnote-convert path/to/notebook.ipynb
 ```
 
-This creates a `notebook.deepnote` file in the current directory containing a single-notebook project. Quarto (`.qmd`), Percent (`.py`), and Marimo (`.py`) files are converted the same way — just pass the file path.
+This creates a `notebook.deepnote` file in the current directory containing a single-notebook project. To convert Quarto (`.qmd`), Percent (`.py`), or Marimo (`.py`) files, pass the file path to the same command.
 
 **Example:**
 
@@ -219,15 +219,15 @@ This workflow allows you to work with Deepnote's enhanced features and collabora
 
 ### Migrating existing projects
 
-Convert an entire project directory — each notebook becomes its own `.deepnote` file:
+Convert an entire project directory. Each notebook becomes its own `.deepnote` file:
 
 ```bash
 deepnote-convert ~/jupyter-projects/data-analysis -o ~/deepnote-projects/
 ```
 
 ### Batch conversion script
 
-Create a script to convert multiple projects. (For a plain directory of notebooks, `deepnote-convert <dir>` already writes one `.deepnote` per notebook — a script like this is only needed for custom logic.)
+Create a script to convert multiple projects. For a plain directory of notebooks, `deepnote-convert <dir>` writes one `.deepnote` file per notebook, so you only need a script for custom logic.
 
 ```typescript
 import { convertIpynbFileToDeepnoteFile } from "@deepnote/convert";

@@ -35,7 +35,7 @@ pip install tensorflow -c https://tk.deepnote.com/constraints<PYTHON_VERSION>.tx
 
 ```
 
-This constraints file helps prevent library conflicts and ensures compatibility with Deepnote's features like the variable explorer and interactive DataFrame views. Don't worry about installing additional dependencies for these features—we'll automatically detect and load them at runtime.
+This constraints file helps prevent library conflicts and ensures compatibility with Deepnote's features like the variable explorer and interactive DataFrame views. You don't need to install dependencies for these features. Deepnote detects and loads them at runtime.
 
 ## How to create a custom environment?
 

@@ -149,7 +149,7 @@ You can also find it in an environment variable `DEEPNOTE_PROJECT_ID` if you wan
 
 Here's an [example notebook](https://deepnote.com/@deepnote/Download-files-in-app-03df4fac-84e9-45c0-aff6-691016698a7b) demonstrating how to do that.
 
-The access controls of the published app are still respected – only people with access to the app can access the files. Note: all files in the /work directory (what you see in the project's **Files** section) can be accessed this way, so make sure you are not exposing anything sensitive.
+The published app's access controls still apply. Only people with access to the app can access the files. Note: all files in the /work directory (what you see in the project's **Files** section) can be accessed this way, so make sure you are not exposing anything sensitive.
 
 Keep in mind that parallel executions of the app (two users at the same time) could overwrite each other's files. If that is a concern, consider generating unique filenames at execution time, and printing the generated URL for each user.
-Original file line number
+Diff line change
@@ Expand Up @@
     ```
-    This constraints file helps prevent library conflicts and ensures compatibility with Deepnote's features like the variable explorer and interactive DataFrame views. Don't worry about installing additional dependencies for these features—we'll automatically detect and load them at runtime.
+    This constraints file helps prevent library conflicts and ensures compatibility with Deepnote's features like the variable explorer and interactive DataFrame views. You don't need to install dependencies for these features. Deepnote detects and loads them at runtime.
     ## How to create a custom environment?
@@ Expand Down @@