Add panel scrolling docs (#11826)

docs/sources/plugins/developing/apps.md

@@ -5,7 +5,7 @@ type = "docs"
 [menu.docs]
 [menu.docs]
 name = "Developing App Plugins"
 name = "Developing App Plugins"
 parent = "developing"
 parent = "developing"
-weight = 6
+weight = 4
 +++
 +++
 
 
 # Grafana Apps
 # Grafana Apps

docs/sources/plugins/developing/datasources.md

@@ -5,7 +5,7 @@ type = "docs"
 [menu.docs]
 [menu.docs]
 name = "Developing Datasource Plugins"
 name = "Developing Datasource Plugins"
 parent = "developing"
 parent = "developing"
-weight = 6
+weight = 5
 +++
 +++
 
 
 # Datasources
 # Datasources

docs/sources/plugins/developing/panels.md

----
-page_title: Plugin panel
-page_description: Panel plugins for Grafana
-page_keywords: grafana, plugins, documentation
----
-
-
 +++
 +++
-title = "Installing Plugins"
+title = "Developing Panel Plugins"
+keywords = ["grafana", "plugins", "panel", "documentation"]
 type = "docs"
 type = "docs"
 [menu.docs]
 [menu.docs]
+name = "Developing Panel Plugins"
 parent = "developing"
 parent = "developing"
-weight = 1
+weight = 4
 +++
 +++
 
 
 
 
@@ -20,7 +15,21 @@ Panels are the main building blocks of dashboards.
 
 
 ## Panel development
 ## Panel development
 
 
-Examples
+
+### Scrolling
+The grafana dashboard framework controls the panel height.  To enable a scrollbar within the panel the PanelCtrl needs to set the scrollable static variable:
+
+```javascript
+export class MyPanelCtrl extends PanelCtrl {
+  static scrollable = true;
+  ...
+```
+
+In this case, make sure the template has a single `<div>...</div>` root.  The plugin loader will modifiy that element adding a scrollbar.
+
+
+
+### Examples
 
 
 - [clock-panel](https://github.com/grafana/clock-panel)
 - [clock-panel](https://github.com/grafana/clock-panel)
 - [singlestat-panel](https://github.com/grafana/grafana/blob/master/public/app/plugins/panel/singlestat/module.ts)
 - [singlestat-panel](https://github.com/grafana/grafana/blob/master/public/app/plugins/panel/singlestat/module.ts)

docs/sources/plugins/developing/plugin.json.md

@@ -5,7 +5,7 @@ type = "docs"
 [menu.docs]
 [menu.docs]
 name = "plugin.json Schema"
 name = "plugin.json Schema"
 parent = "developing"
 parent = "developing"
-weight = 6
+weight = 8
 +++
 +++
 
 
 # Plugin.json
 # Plugin.json