docs: rewrite data catalog guide

Signed-off-by: Srihari Thyagarajan <hari.leo03@gmail.com>
Haleshot · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026 · Aug 28, 2026
commit 9d654fb6e0f642880e31b9fa175b96c81f3ecab8
@@ -4,90 +4,36 @@ noIndex: false
 noContent: false
 ---
 
-Data cataloging is a game-changer in modern data management. At the forefront of this revolution is Deepnote, an AI-powered data workspace. Let’s dive into data cataloging, the unique capabilities of Deepnote, and how it empowers data scientists, analysts, and engineers to achieve greater insights and efficiency.
+A data catalog records an organization's data assets and the metadata that describes them. It helps users find a dataset, understand its source and schema, assess its quality, and check who can access it.
 
-**What is a data catalog?** A data catalog is a comprehensive inventory of an organization's data assets. It uses metadata aka data about data, to provide detailed descriptions, helping users quickly locate, evaluate, and understand the data they need. This inventory includes structured data like tables and charts, unstructured data such as documents and images, and machine learning models and visualizations. Key components of a data catalog:
+A catalog can include tables, charts, documents, images, machine learning models, and visualizations. Search, tags, filters, lineage, quality metrics, and access controls make those assets easier to find and evaluate.
 
-- **Metadata management**: collects and organizes metadata to describe data assets.
-- **Search functionality**: facilitates easy discovery of data through keyword search, tagging, and filters.
-- **Data evaluation**: provides context and quality metrics to assess data suitability for specific uses.
-- **Access control**: ensures secure access to data, maintaining compliance with regulations.
+## Build a data catalog in Deepnote
 
-## Why data cataloging is crucial
+Use Markdown blocks to document each dataset's source, creation date, schema, and purpose. Profile the data to find missing values, outliers, or inconsistencies, and add summary statistics or visualizations when they help readers understand the dataset.
 
-Implementing a robust data catalog offers numerous benefits:
+Folders and tags can organize related datasets. Deepnote's version history records changes to the notebook, so your team can review updates to the catalog over time.
 
-- **Improved efficiency**: streamlines data discovery and reduces time spent searching for data.
-- **Enhanced data context**: provides comprehensive metadata that helps users understand data relevance and quality.
-- **Reduced errors**: ensures data accuracy by maintaining detailed data lineage and quality information.
-- **Better decision-making**: facilitates quicker and more informed decisions by providing easy access to high-quality data.
-
-## Deepnote's approach to data cataloging
-
-Deepnote takes data cataloging to the next level by offering a seamless, collaborative, and intuitive platform specifically designed for data professionals.
-
-**Documenting and describing datasets**: use Markdown blocks to document each dataset, including metadata such as source, creation date, and data schema. Detailed descriptions maintain clarity and context.
-
-**Data profiling and cleaning**: identify and correct missing values, outliers, and inconsistencies through data profiling. This ensures the quality and integrity of your datasets.
-
-**Incorporating visualizations and summary statistics**: add visualizations using libraries like Seaborn to provide a quick overview of the data. This helps in understanding data patterns and making informed decisions.
-
-**Collaborating with team members**: share your Deepnote project and set permissions for team members to ensure effective teamwork and data integrity, or create a [Deepnote app](https://deepnote.com/docs/data-apps) that you embedded in a document for your coworkers.
-
-**Organizing and managing datasets**: use folders and tags to organize your project. This ensures a streamlined workflow and easy retrieval of datasets.
-
-**Maintaining an up-to-date data catalog**: regularly updating documentation and metadata. Use version control to track changes and set periodic reviews to ensure data accuracy and relevance.
-
-Deepnote offers several unique ways that make it an ideal platform for data cataloging:
-
-- **Seamless integration**: integrates with various data sources, allowing easy import and management of datasets.
-- **Collaborative environment**: enables real-time teamwork with robust sharing and permission-setting features.
-- **Interactive visualizations**: provides tools to create visualizations and summary statistics for quick data insights.
-- **Enhanced documentation**: utilizes Markdown blocks for comprehensive documentation, ensuring clarity and context.
-- **Interactive data applications**: allows the creation of interactive data applications within Deepnote, streamlining the cataloging process.
-
-By integrating Deepnote into your data management workflow, you can significantly enhance your ability to catalog, manage, and analyze datasets. This leads to better decision-making, increased efficiency, and a deeper understanding of your data assets.
-
-- **Empowers users**: Deepnote's intuitive interface and powerful features empower data professionals to take control of their data cataloging processes.
-- **Promotes collaboration**: encourages teamwork and knowledge sharing, fostering a collaborative data culture within organizations.
-- **Drives innovation**: by simplifying complex processes, Deepnote allows data professionals to focus on innovation and derive actionable insights from their data.
+Share the project with teammates and set view or edit permissions for each collaborator. You can also publish the catalog as a [Deepnote app](https://deepnote.com/docs/data-apps) and embed it in another document.
 
 ## Example of data cataloging in Deepnote
 
-We prepared an [example notebook](https://deepnote.com/workspace/Deepnote-Templates-71742312-24f2-4c10-9bf7-786d17280b92/project/Data-catalog-34f035b4-bb25-410b-ac79-5c60c6ccc5cb/notebook/%F0%9F%93%9D%20Introduction%20-f00a6fdd779148238e351b26646bcfe7) with [Atlan API](https://atlan.com/) that you can duplicate, play around, or use for your data set. There are multiple levels that you can explore depends on your seniority and use case.
+The [example data catalog notebook](https://deepnote.com/workspace/Deepnote-Templates-71742312-24f2-4c10-9bf7-786d17280b92/project/Data-catalog-34f035b4-bb25-410b-ac79-5c60c6ccc5cb/notebook/%F0%9F%93%9D%20Introduction%20-f00a6fdd779148238e351b26646bcfe7) uses the [Atlan API](https://atlan.com/). Duplicate it to explore the setup or adapt it to your datasets.
 
 ## Collaborating and sharing your data catalog
 
-**Share your notebook**
-
-- Click on the “Share” button in the top-right corner of the notebook.
-- Set permissions for your collaborators (e.g., view, edit).
-- Share the link with your team.
-- Create a [data app](https://deepnote.com/docs/data-apps) from your data catalog
+1. Click **Share** in the top-right corner of the notebook.
+2. Set view or edit permissions for each collaborator.
+3. Share the link with your team, or create a [data app](https://deepnote.com/docs/data-apps) from the catalog.
 
-**Collaborate in real-time**
-
-- Collaborate with your team by allowing them to add, edit, or comment on the notebook.
-- Use comments to discuss dataset details or flag issues that need attention.
+Collaborators can add, edit, or comment on the notebook. Use comments to discuss dataset details or flag issues.
 
 ## Maintaining and updating your data catalog
 
-**Regular updates**: set a schedule for reviewing and updating your data catalog. This ensures that all information is current and accurate.
-
-Example: Every month, review the datasets and update any changes in schema, data sources, or descriptions.
-
-**Version control:** utilize Deepnote’s version control features to track changes in your notebook.
-
-This helps maintain a history of updates and allows you to revert to previous versions if needed.
-
-In the rapidly evolving landscape of data management, having a robust data catalog is no longer optional—it's essential. Deepnote not only makes data cataloging more accessible but also enhances it with features tailored to the needs of data professionals. By leveraging Deepnote's capabilities, you can transform your data cataloging process, driving better decision-making and unlocking the full potential of your data.
-
-Ready to streamline your data cataloging process? Sign up for Deepnote today and experience the benefits firsthand. Empower your data teams, enhance collaboration, and drive innovation with Deepnote—the leading platform for data cataloging.
-
-For those interested in further exploring the capabilities of Deepnote and how it can revolutionize your data management processes, here are some additional resources:
+Set a review schedule for the catalog. During each review, record changes to schemas, data sources, and descriptions. Use version history to inspect past updates or restore an earlier version.
 
-- [**Getting started with Deepnote**](https://deepnote.com/docs): Learn the basics of setting up and using Deepnote for your data projects.
-- [**Deepnote integrations**](https://deepnote.com/integrations): Discover how to connect Deepnote with your existing data sources and tools.
-- [**Case studies**](https://deepnote.com/customers): See how other organizations are using Deepnote to enhance their data practices and drive success.
+## Related resources
 
-Feel free to reach out to our support team if you have any questions or need assistance getting started with Deepnote. Happy data cataloging!
+- [Getting started with Deepnote](https://deepnote.com/docs)
+- [Deepnote integrations](https://deepnote.com/integrations)
+- [Customer stories](https://deepnote.com/customers)