Skip to content

Kepler.gl is a powerful open source geospatial analysis tool for large-scale data sets.

[Docs] Add get started section (#69)

Shan He2f428e764de6
diff --git a/docs/a-introduction.md b/docs/a-introduction.md
index fd4164d1e..7723beec4 100644
--- a/docs/a-introduction.md
+++ b/docs/a-introduction.md
@@ -6,7 +6,7 @@ Visualize a large amount of location data in your browser.
Playback geo-temporal trends over time.
Explore, filter, and deeply engage with location data to gain insight
-See the sample maps in the demo app for more examples.
+See the sample maps in the demo app for more examples.
![Kepler.gl sample map](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image11.png "Kepler.gl sample map")
@@ -14,7 +14,9 @@ This guide will teach you how to perform data analysis in Kepler.gl by adding da
## Table of contents:
-### Introduction
+### Get Started
+
+[Get Started](./j-get-started.md)
### The kepler.gl workflow
diff --git a/docs/g-map-settings.md b/docs/g-map-settings.md
index 30d131322..20e04c941 100644
--- a/docs/g-map-settings.md
+++ b/docs/g-map-settings.md
@@ -6,8 +6,10 @@ You can toggle customization options on your map, including tooltips, brush high
To toggle customization options on your map:
1. Open the Interactions menu by clicking the Interactions icon:
+
![Interaction menu](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image30.png "Interaction menu")
2. Click the switch next to the options you wish to activate/deactivate.
+
![activate interactions](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image32.png "activate interactions")
There are two types of interactions to choose from: Tooltips and Brush. Note that only one can be on at a time.
diff --git a/docs/j-get-started.md b/docs/j-get-started.md
index 2813d0861..1d9fa1084 100644
--- a/docs/j-get-started.md
+++ b/docs/j-get-started.md
@@ -3,7 +3,9 @@
Kepler.gl is a tool designed for geospatial data analysis. This guide will help you get started creating visualizations in kepler.gl.
-1) Add Data to your Map
+## 1) Add Data to your Map
+
+![Add data to the map pop up](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image42.png "Add data to the map pop up")
Kepler.gl will prompt you to add data to your map as soon as you open the web page. Upload your own CSV or GEOJSON file, or add kepler.gl sample data.
Sample data is a great way to explore and get familiar with kepler.gl’s features.
@@ -11,10 +13,29 @@ Sample data is a great way to explore and get familiar with kepler.gl’s featur
Read more about adding [Add data to the map](./b-kepler.gl-workflow/a-add-data-to-the-map.md).
-2) Add Layers
+## 2) Add Layers
+
+![Add layer](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image16.png "Add layer")
Open the Data Layers menu to start building your visualization. Layers are simply data visualizations that can be built on top of one another. The map pictured above contains a GeoJSON path layer showing trip routes.
If you’re new to kepler.gl, play around with the different settings for each type of layer. Layers of the same type can differ greatly in appearance depending on how they’re configured, opening up new possibilities for data analysis.
-Learn more about layers.
+Learn more about [adding data layers](./b-kepler-gl-workflow/b-add-data-layers/a-adding-data-layers.md)
+.
+
+## 3) Add Filters
+
+![choose a dataset](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image29.png "choose a dataset")
+
+Add filters to your map to limit the data that is displayed. Filters must be based on the columns in your dataset. To create a new filter, open the Filter menu and click Add Filter. Note that filters apply to all layers and cannot be toggled on and off.
+
+Learn more about [filters](./e-filters.md).
+
+## 4) Customize Map Settings
+
+![activate interactions](https://d1a3f4spazzrp4.cloudfront.net/kepler.gl/documentation/image32.png "activate interactions")
+
+Change the settings on your map in the Interactions and Base Map menus. Customization options include tooltips, brush highlighting, base map style, map imagery toggles (water, parks, satellite image, etc.), and many more.
+
+Read about [base map styles](./f-map-styles/1-base-map-styles.md) and [map settings](./g-map-settings.md).
diff --git a/website/src/content.js b/website/src/content.js
index 56b39a525..1a330b84c 100644
--- a/website/src/content.js
+++ b/website/src/content.js
@@ -72,7 +72,7 @@ export const HERO_IMAGES_SCALED = [
export const HEADER_NAVS = [
{
text: 'Get Started',
- link: 'https://github.com/uber/kepler.gl/blob/master/docs/a-introduction.md'
+ link: 'https://github.com/uber/kepler.gl/blob/get-started/docs/j-get-started.md'
},
{