URL service docs (#125697)

* improve sharing menu docs

* improve locator docs

* improve locator docs

* add short URL docs

* add tsconfig

* update plugin list

* add share plugin readme to dev docs

* fix linter errors

* update docs list

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>

examples/share_examples/README.md

@@ -0,0 +1,3 @@
+# Share plugin examples
+
+Small demos of share plugin usage.

examples/share_examples/kibana.json

@@ -0,0 +1,14 @@
+{
+  "id": "shareExamples",
+  "kibanaVersion": "kibana",
+  "version": "0.0.1",
+  "server": false,
+  "ui": true,
+  "owner": {
+    "name": "App Services",
+    "githubTeam": "kibana-app-services"
+  },
+  "description": "Small demos of share plugin usage",
+  "requiredPlugins": ["share"],
+  "optionalPlugins": []
+}

examples/share_examples/public/index.ts

@@ -0,0 +1,11 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { ShareDemoPlugin } from './plugin';
+
+export const plugin = () => new ShareDemoPlugin();

examples/share_examples/public/plugin.tsx

@@ -0,0 +1,42 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { SharePluginStart, SharePluginSetup } from '../../../src/plugins/share/public';
+import { Plugin, CoreSetup, CoreStart } from '../../../src/core/public';
+
+interface SetupDeps {
+  share: SharePluginSetup;
+}
+
+interface StartDeps {
+  share: SharePluginStart;
+}
+
+export class ShareDemoPlugin implements Plugin<void, void, SetupDeps, StartDeps> {
+  public setup(core: CoreSetup<StartDeps>, { share }: SetupDeps) {
+    share.register({
+      id: 'demo',
+      getShareMenuItems: (context) => [
+        {
+          panel: {
+            id: 'demo',
+            title: 'Panel title',
+            content: 'Panel content',
+          },
+          shareMenuItem: {
+            name: 'Demo list item (from share_example plugin)',
+          },
+        },
+      ],
+    });
+  }
+
+  public start(core: CoreStart, { share }: StartDeps) {}
+
+  public stop() {}
+}

examples/share_examples/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./target/types"
+  },
+  "include": [
+    "index.ts",
+    "public/**/*.ts",
+    "public/**/*.tsx",
+    "server/**/*.ts",
+    "../../typings/**/*"
+  ],
+  "exclude": [],
+  "references": [
+    { "path": "../../src/core/tsconfig.json" },
+    { "path": "../../src/plugins/share/tsconfig.json" },
+  ]
+}