From f4ccc633437fadf7902ea5c4b56954dfafd94cec Mon Sep 17 00:00:00 2001
From: Robert H Stolz <7143905+garden-of-delete@users.noreply.github.com>
Date: Tue, 26 Jan 2021 17:30:55 -0800
Subject: [PATCH] docs: 1.0.0 release notes update: media + feature flags
(#12781)
* Converted oversized .png back to .jpg to pass the filesize check.
* added downsized media for really real this time.
---
RELEASING/release-notes-1-0/README.md | 20 ++++++++++--------
.../media/alerts_reports_2.jpg | Bin 94135 -> 0 bytes
.../media/alerts_reports_2.png | Bin 0 -> 103178 bytes
.../media/alerts_reports_3.jpg | Bin 246018 -> 0 bytes
.../media/alerts_reports_3.png | Bin 0 -> 290154 bytes
.../release-notes-1-0/media/annotations.jpg | Bin 140131 -> 0 bytes
.../release-notes-1-0/media/annotations.png | Bin 0 -> 269526 bytes
.../media/dashboard_card_view.jpg | Bin 143732 -> 323422 bytes
.../media/echarts_timeseries_prophet.jpg | Bin 133133 -> 0 bytes
.../media/echarts_timeseries_prophet.png | Bin 0 -> 327295 bytes
.../release-notes-1-0/media/explore_ui.jpg | Bin 154997 -> 0 bytes
.../release-notes-1-0/media/explore_ui.png | Bin 0 -> 306308 bytes
.../release-notes-1-0/media/filter_status.jpg | Bin 80750 -> 0 bytes
.../release-notes-1-0/media/filter_status.png | Bin 0 -> 361666 bytes
.../release-notes-1-0/media/home_screen.jpg | Bin 127474 -> 0 bytes
.../release-notes-1-0/media/home_screen.png | Bin 0 -> 258545 bytes
.../release-notes-1-0/media/rest_api.jpg | Bin 257246 -> 0 bytes
.../release-notes-1-0/media/rest_api.png | Bin 0 -> 65556 bytes
.../media/rest_api_swagger.jpg | Bin 148099 -> 0 bytes
.../media/rest_api_swagger.png | Bin 0 -> 72432 bytes
20 files changed, 11 insertions(+), 9 deletions(-)
delete mode 100644 RELEASING/release-notes-1-0/media/alerts_reports_2.jpg
create mode 100644 RELEASING/release-notes-1-0/media/alerts_reports_2.png
delete mode 100644 RELEASING/release-notes-1-0/media/alerts_reports_3.jpg
create mode 100644 RELEASING/release-notes-1-0/media/alerts_reports_3.png
delete mode 100644 RELEASING/release-notes-1-0/media/annotations.jpg
create mode 100644 RELEASING/release-notes-1-0/media/annotations.png
delete mode 100644 RELEASING/release-notes-1-0/media/echarts_timeseries_prophet.jpg
create mode 100644 RELEASING/release-notes-1-0/media/echarts_timeseries_prophet.png
delete mode 100644 RELEASING/release-notes-1-0/media/explore_ui.jpg
create mode 100644 RELEASING/release-notes-1-0/media/explore_ui.png
delete mode 100644 RELEASING/release-notes-1-0/media/filter_status.jpg
create mode 100644 RELEASING/release-notes-1-0/media/filter_status.png
delete mode 100644 RELEASING/release-notes-1-0/media/home_screen.jpg
create mode 100644 RELEASING/release-notes-1-0/media/home_screen.png
delete mode 100644 RELEASING/release-notes-1-0/media/rest_api.jpg
create mode 100644 RELEASING/release-notes-1-0/media/rest_api.png
delete mode 100644 RELEASING/release-notes-1-0/media/rest_api_swagger.jpg
create mode 100644 RELEASING/release-notes-1-0/media/rest_api_swagger.png
diff --git a/RELEASING/release-notes-1-0/README.md b/RELEASING/release-notes-1-0/README.md
index 61b2844f525b6..1ce27ae2aad6e 100644
--- a/RELEASING/release-notes-1-0/README.md
+++ b/RELEASING/release-notes-1-0/README.md
@@ -25,6 +25,8 @@ Superset 1.0 is a ***huge milestone*** for Apache Superset. This release holds a
- [**New Features**](#new-features)
- [**Stability and Bugfixes**](#stability-and-bugfixes)
+Some of the new features in this release are disabled by default. Each has a feature flag in `config.py` and some require configuration of additional back-end dependencies, such as Celery. See [this table](https://superset.apache.org/docs/version-one#start-using-superset-10) for a list of features and their associated flags and dependencies.
+
# User Experience
We have taken the Superset user experience to the next level with a much simpler, more intuitive UI.
@@ -34,7 +36,7 @@ Lists of Charts and Dashboards can be shown in a new format using a **thumbnail
Visualization controls have been updated to create a more consistent and modernized interface. Refactoring includes updates to the content/labeling/ordering of these controls as well as updating their styling and simplifying their interactions and layout. This will line us up for features like drag-and-drop controls, and dynamically populated control inputs in future releases.
-
+
Users also now have the ability to create and name a new dataset or update an existing dataset when moving from **SQL Lab** to **Explore**. When going back to SQL Lab, the underlying query for the dataset will be shown, allowing users to easily make changes and update their dataset when moving between SQL Lab and Explore.
@@ -47,11 +49,11 @@ Superset 1.0 makes it easier for developers to build, deploy, and maintain Super
The **REST API** continues to see improvement as well, with new endpoints and improvements to existing endpoints. More details [here](https://superset.apache.org/docs/rest-api).
-
+
The Swagger interface can be used to explore and try out these changes.
-
+
See related PR highlights [here](#developer-experience-1).
@@ -63,25 +65,25 @@ See related PR highlights [here](#performance-1).
# New Features
Superset 1.0 includes a slew of new features and other enhancements. **New visualization plugin architecture** will make it easier to build, test, style and configure custom visualizations for Superset. **Dynamic viz plugin** imports will allow Superset to load data viz plugins, allowing developers to more easily use or share their custom plugins and **load custom plugins on-demand** from anywhere on the web. Superset has also adopted [**Apache ECharts**](https://echarts.apache.org/en/index.html) as the core library for new visualizations.
-
+
Along with the **Echarts integration**, we are also introducing a better set of annotation features. **Formula annotation**, which allows users to plot any mathematical function on the chart; **Interval and Event annotations**, which allow users to add context to the trend in Time-Series; and **Line annotation**, which use a predefined chart as the source of annotation.
-
+
A redesigned home screen provides a **personalized landing page** that the user sees when they log into Superset, improving discoverability. It shows items relevant to the user (Charts, Dashboards, Saved Queries, etc) and serves as a hub to discover content and access recent items quickly.
-
+
Charts on dashboards have been updated to concisely show which **filters** are in scope, have been applied, or are in error. Context around filter changes has been increased by highlighting scoped charts when a filter is selected and increasing visibility of charts with incompatible filters applied.
-
+
**Alerts and reporting** have received a robust backend and UI overhaul.
-
+
-
+
See related PR highlights [here](#new-features-1).
diff --git a/RELEASING/release-notes-1-0/media/alerts_reports_2.jpg b/RELEASING/release-notes-1-0/media/alerts_reports_2.jpg
deleted file mode 100644
index 2ea7fbb0c126fbefba2f548aff4155f0c27706d7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 94135
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