[docs] User tutorial

[francishemingway]

CATEGORY

Choose one

• Bug Fix
• Enhancement (new features, refinement)
• Refactor
• Add tests
• Build / Development Environment
• Documentation

SUMMARY

A new tutorial that focusing more on how an end user might use Superset, rather than how an administrator might set it up and get it working for the first time. I have added this as a new rst file, and changed the hierarchy within the documents so that there's now a tutorials page, with links to the existing tutorial and the new one.

The tutorial starts with basic instructions on how to load CSV data into superset and create a visualization. It then progresses through some different visualizations (pivot, bar chart, line chart), dashboard elements (filters, markdown and publishing). Then, it covers some more advanced features: advanced analytics and annotations.

Here's a screenshot of the new hierarchy of tutorials:

Full text of the tutorial is here (you should be able to comment).

ADDITIONAL INFORMATION

This tutorial is based on a real dataset from here which is a set of flights taken by an organization in 2011. This data is licensed under the Open Government Licence v3.0, an ASF category A license. Then it was combined with data from here, licensed under the public domain. Then I tidied it up by removing a single line (a flight with the same origin and destination). It's currently on my github.

Questions I have:

It would be great to get some guidance on the following:

• Is there somewhere within the project's repositories to host the data file.
• Should I open a new issue? This addresses more fully Tutorials #698.

[codecov-io]

Codecov Report

Merging #8459 into master will increase coverage by 0.09%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master    #8459      +/-   ##
==========================================
+ Coverage   66.58%   66.68%   +0.09%     
==========================================
  Files         448      449       +1     
  Lines       22492    22687     +195     
  Branches     2364     2366       +2     
==========================================
+ Hits        14976    15128     +152     
- Misses       7378     7421      +43     
  Partials      138      138

Impacted Files	Coverage Δ
superset/db_engine_specs/oracle.py	66.66% <0%> (-25%)	⬇️
superset/db_engine_specs/mssql.py	48.83% <0%> (-9.5%)	⬇️
superset/db_engine_specs/impala.py	59.09% <0%> (-5.91%)	⬇️
superset/db_engine_specs/sqlite.py	66.66% <0%> (-4.31%)	⬇️
superset/db_engine_specs/bigquery.py	42.66% <0%> (-2.41%)	⬇️
superset/views/database/__init__.py	78.78% <0%> (-1.22%)	⬇️
.../explore/components/controls/DatasourceControl.jsx	67.74% <0%> (-1.01%)	⬇️
superset/db_engine_specs/postgres.py	83.33% <0%> (-0.54%)	⬇️
.../assets/src/SqlLab/components/TabbedSqlEditors.jsx	83.03% <0%> (-0.3%)	⬇️
superset/views/core.py	71.96% <0%> (-0.25%)	⬇️
... and 28 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update eaeed0c...deec84d. Read the comment docs.

[etr2460]

This looks awesome, would you mind attaching some screenshots of the new documentation to make it a bit easier to review?

also, @sylvia-tomiyama you might be interested in this

[francishemingway]

@etr2460 , @sylvia-tomiyama
I have added a screenshot to show the new organization of tutorials. Below that I've linked to the text in a google doc (it's about 2,500 words, so it's not going to fit in a screenshot). You should be able comment - let me know if not.

[etr2460]

Great, that's perfect! To answer your other questions:

• you can put your example data in this repo https://github.com/apache-superset/examples-data. We also have a bunch of logic in superset already for loading example data in this directory: https://github.com/apache/incubator-superset/tree/master/superset/examples. However, I think it's better to keep the csv upload part of the tutorial, so hosting the data in that repo should be sufficient. Feel free to ping me for the PR review.
• Don't worry about making a new issue, we don't use issues very much anyway

I'll review and accept once the examples data PR is done and the link is replaced here

[willbarrett]

I saw a few minor language tweaks that could be good, my only blocker is moving the data to the already-recommended repo. Thank you very much for doing this!

[francishemingway]

@willbarrett - thanks very much for your feedback!

@etr2460 - I have created a pull request in the other repo here and I've updated the URL in this pull request to reflect where the new file will be.

[etr2460]

The other PR is merged now, so once you address the other comments this should be good to go!

[francishemingway]

@etr2460 I've updated based on all of the feedback now. Unless there's any more feedback, should be good to go.

[etr2460]

lgtm, thanks for adding all this documentation!