Posting insights

When you have findings, conclusions, or interesting points for discussion about your project, the insights section is the place to do it. Insights allow you to capture the conclusions from your work, packaging them up 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
• On the Insights tab
• From Chart Builder, data.world's built-in visualization tool. (see the article Data Visualization with Chart Builder for details) 

When you click on the link for a new insight you will get a dialog asking you what kind of insight you'd like to add:

Adding Images

To add an image as an insight, click on New insight and select Image. From there you can either browse your files or drag and drop the image file you would like to add into the grey box:

Once you have the image you want, you need to add a title.

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.

Comments are optional, but this is a good area to explain your photo and its bearing on the project. Only one image can be shown per insight, but additional images can be included in the Comment box by dragging and drop them there. Appropriate Markdown text for the embedded image is automatically generated:

and one image is shown in the insight with the other being linked to in the comments:

Embedding

Embedding provides you with an easy way of adding links to resources from other tools into  insights:

In this example we are embedding a link to a National Geographic web page with shark attack statistics. The resulting insight is rendered with both the link to the site and the main image:

Markdown

The most flexible way to create feature-rich insights is to use the markdown option. With markdown you can incorporate text, links, images, headers, lists, tables, and more into your insight. For detailed instructions on using Markdown, see our Markdown Tutorial. 

The following screenshot is of an insight being created with markdown and includes a list of take-aways and a graph:

This is how the markdown is rendered in the insight: