Posting insights

When you have findings, conclusions, or interesting points for discussion about your project, you can create an Insight to display them prominently and invite discussion with other contributors to the project. Insights allow you to capture the conclusions from your work and present them in a way that quickly communicates a nugget of information, while giving the viewer the tools they need to dig down into your methods and sources. Insights balance efficiency of communication with reproducibility--two concepts that are often at odds in this phase of data work.

You can use insights to capture the results and analysis of your work and synthesize them so they are understandable and accessible to stakeholders at all levels in the project. Insights can be created by the project owner and any contributors, and are the first thing that displays on the main overview page. They also have their own tab in the project.

There are several places you can add an insight to your project:

• On the Overview tab with the New insight button

• On the Insights tab with the Add a new insight button

• From the project workspace after clicking the + Add button 

• From Chart Builder, data.world's built-in visualization tool, using the Share button on the top right (see the article Data Visualization with Chart Builder for details)

NOTE: Insight titles are a main search field in data.world. Make sure you use a descriptive title so it can be easily found with search. To find out more about how search works see the article Using Search. 

When you create a new Insight, you will enter the Simple Editor - the same editor used for dataset and project summaries.  You can switch to Markdown from the link next to the Done button if you prefer. For more information on using the Simple Editor, see:

• Intro to the Simple Data Documentation Editor
• Using the Simple Editor command menu
• Embedding assets with the Simple Editor

 For more information on Markdown see our  Markdown syntax reference.