From c431cb5f250087e992c6b234940fceb80b0e6de1 Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Wed, 18 Aug 2021 19:07:57 -0400
Subject: [PATCH] Add deprecation notice to dashboard import/export docs.
 (#108826) (#109176)

Co-authored-by: Luke Elmers <luke.elmers@elastic.co>
---
 docs/api/dashboard-api.asciidoc              | 2 ++
 docs/api/dashboard/export-dashboard.asciidoc | 4 +++-
 docs/api/dashboard/import-dashboard.asciidoc | 4 +++-
 docs/user/dashboard/dashboard.asciidoc       | 2 +-
 src/plugins/legacy_export/README.md          | 2 +-
 src/plugins/legacy_export/server/plugin.ts   | 1 +
 6 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/docs/api/dashboard-api.asciidoc b/docs/api/dashboard-api.asciidoc
index 50c2abc9757634..e6f54dd9156ecb 100644
--- a/docs/api/dashboard-api.asciidoc
+++ b/docs/api/dashboard-api.asciidoc
@@ -1,6 +1,8 @@
 [[dashboard-api]]
 == Import and export dashboard APIs
 
+deprecated::[7.15.0,Both of these APIs have been deprecated in favor of <<saved-objects-api-import>> and <<saved-objects-api-export>>.]
+
 Import and export dashboards with the corresponding saved objects, such as visualizations, saved
 searches, and index patterns.
 
diff --git a/docs/api/dashboard/export-dashboard.asciidoc b/docs/api/dashboard/export-dashboard.asciidoc
index 6d239d755eb0d0..3a20eff0a54d25 100644
--- a/docs/api/dashboard/export-dashboard.asciidoc
+++ b/docs/api/dashboard/export-dashboard.asciidoc
@@ -4,7 +4,9 @@
 <titleabbrev>Export dashboard</titleabbrev>
 ++++
 
-experimental[] Export dashboards and corresponding saved objects.
+deprecated::[7.15.0,Use <<saved-objects-api-export>> instead.]
+
+Export dashboards and corresponding saved objects.
 
 [[dashboard-api-export-request]]
 ==== Request
diff --git a/docs/api/dashboard/import-dashboard.asciidoc b/docs/api/dashboard/import-dashboard.asciidoc
index 5d1fab41a2a140..e4817d6cb7ee9b 100644
--- a/docs/api/dashboard/import-dashboard.asciidoc
+++ b/docs/api/dashboard/import-dashboard.asciidoc
@@ -4,7 +4,9 @@
 <titleabbrev>Import dashboard</titleabbrev>
 ++++
 
-experimental[] Import dashboards and corresponding saved objects.
+deprecated::[7.15.0,Use <<saved-objects-api-import>> instead.]
+
+Import dashboards and corresponding saved objects.
 
 [[dashboard-api-import-request]]
 ==== Request
diff --git a/docs/user/dashboard/dashboard.asciidoc b/docs/user/dashboard/dashboard.asciidoc
index 374dc4f735e9be..6430c5d246dc6e 100644
--- a/docs/user/dashboard/dashboard.asciidoc
+++ b/docs/user/dashboard/dashboard.asciidoc
@@ -345,7 +345,7 @@ To share the dashboard with a larger audience, click *Share* in the toolbar. For
 [[import-dashboards]]
 == Export dashboards
 
-To automate {kib}, you can export dashboards as JSON using the <<dashboard-api,import and export dashboard APIs>>. It is important to export dashboards with all necessary references.
+To automate {kib}, you can export dashboards as NDJSON using the <<saved-objects-api-export, Export objects API>>. It is important to export dashboards with all necessary references.
 
 --
 include::tutorial-create-a-dashboard-of-lens-panels.asciidoc[]
diff --git a/src/plugins/legacy_export/README.md b/src/plugins/legacy_export/README.md
index 050e39b8f19e4a..551487a1122fcd 100644
--- a/src/plugins/legacy_export/README.md
+++ b/src/plugins/legacy_export/README.md
@@ -1,3 +1,3 @@
-# `legacyExport` plugin
+# `legacyExport` plugin [deprecated]
 
 The `legacyExport` plugin adds support for the legacy saved objects export format.
diff --git a/src/plugins/legacy_export/server/plugin.ts b/src/plugins/legacy_export/server/plugin.ts
index ac38f300bd02b5..a6bdcdc19b0a1b 100644
--- a/src/plugins/legacy_export/server/plugin.ts
+++ b/src/plugins/legacy_export/server/plugin.ts
@@ -9,6 +9,7 @@
 import { Plugin, CoreSetup, PluginInitializerContext } from 'kibana/server';
 import { registerRoutes } from './routes';
 
+/** @deprecated */
 export class LegacyExportPlugin implements Plugin<{}, {}> {
   constructor(private readonly initContext: PluginInitializerContext) {}