Merge branch 'master' into tst_custom

* master:
  Moved doc task to the end of the default task chain
  removed y_as_bytes, replaced with y_format
  Remove console.log
  Closes elastic#538. Closes elastic#722
  Potential fix for elastic#621
  More small table performance improvements
  Improve performance in the table. Re elastic#719 and elastic#732
  Remove idQueue from filter and query services in dashboards
  Eliminate idQueue property from filterSrv and querySrv. Replace with binary search for smallest id. Closes elastic#730. Closes elastic#739
  Skeleton API docs
  Doc updates
  Added scratchy tasks and config.js docs
  Bytes should not be default
  Fixing unsafe html binding
  fixed numeric terms in topN query
  do not auto-enable saved filters

Gruntfile.js

@@ -8,6 +8,7 @@ module.exports = function (grunt) {
     srcDir: 'src',
     destDir: 'dist',
     tempDir: 'tmp',
+    docsDir: 'docs/'
   };
 
   // load plugins

docs/kibana/configuration/config.js.asciidoc

@@ -0,0 +1,29 @@
+== Configuration ==
+config.js is where you will find the core Kibana configuration. This file contains parameter that
+must be set before kibana is run for the first time.
+// src/config.js:1
+
+=== Parameters ===
+// src/config.js:10
+
+==== elasticsearch ====
+
+The URL to your elasticsearch server. You almost certainly don't
+want +http://localhost:9200+ here. Even if Kibana and Elasticsearch are on
+the same host. By default this will attempt to reach ES at the same host you have
+elasticsearch installed on. You probably want to set it to the FQDN of your
+elasticsearch host
+// src/config.js:15
+
+==== kibana-int ====
+
+The default ES index to use for storing Kibana specific object
+such as stored dashboards
+// src/config.js:26
+
+==== panel_name ====
+
+An array of panel modules available. Panels will only be loaded when they are defined in the
+dashboard, but this list is used in the "add panel" interface.
+// src/config.js:34
+

docs/kibana/index.asciidoc

@@ -0,0 +1,18 @@
+= Kibana
+
+// Why can't I have a preamble here?
+
+== Introduction
+
+Kibana is an open source (Apache Licensed), browser based analytics and search dashboard for
+ElasticSearch. Kibana is a snap to setup and start using. Written entirely in HTML and Javascript
+it requires only a plain webserver, Kibana requires no fancy server side components.
+Kibana strives to be easy to get started with, while also being flexible and powerful, just like
+Elasticsearch.
+
+include::configuration/config.js.asciidoc[]
+
+include::panels.asciidoc[]
+
+// src/app/controllers/dash.js:1
+

docs/kibana/panels.asciidoc

@@ -0,0 +1,64 @@
+[[panels]]
+= Panels
+
+[partintro]
+--
+*Kibana* dashboards are made up of blocks called +panels+. Panels are organized into rows
+and can serve many purposes, though most are designed to provide the results of a query or
+multiple queries as a visualization. Other panels may show collections of documents or
+allow you to insert instructions for your users.
+
+Panels can be configured easily via the Kibana web interface. For more advanced usage, such
+as templated or scripted dashboards, documentation of panel properties is available in this
+section. You may find settings here which are not exposed via the web interface.
+
+Each panel type has its own properties, hover there are several that are shared.
+
+// src/app/controllers/row.js:61
+
+span:: A number, 1-12, that describes the width of the panel.
+// src/app/controllers/row.js:87
+
+editable:: Enable or disable the edit button the the panel
+// src/app/controllers/row.js:91
+
+type:: The type of panel this object contains. Each panel type will require additional
+properties. See the panel types list to the right.
+// src/app/controllers/row.js:95
+
+--
+// src/app/controllers/row.js:103
+
+include::panels/bettermap.asciidoc[]
+// src/app/panels/bettermap/module.js:1
+
+include::panels/column.asciidoc[]
+// src/app/panels/column/module.js:1
+
+include::panels/histogram.asciidoc[]
+// src/app/panels/histogram/module.js:1
+
+include::panels/hits.asciidoc[]
+// src/app/panels/hits/module.js:1
+
+include::panels/map.asciidoc[]
+// src/app/panels/map/module.js:1
+
+include::panels/pie.asciidoc[]
+// src/app/panels/pie/module.js:1
+
+include::panels/sparklines.asciidoc[]
+// src/app/panels/sparklines/module.js:1
+
+include::panels/table.asciidoc[]
+// src/app/panels/table/module.js:1
+
+include::panels/terms.asciidoc[]
+// src/app/panels/terms/module.js:1
+
+include::panels/text.asciidoc[]
+// src/app/panels/text/module.js:1
+
+include::panels/trends.asciidoc[]
+// src/app/panels/trends/module.js:1
+

docs/kibana/panels/bettermap.asciidoc

@@ -0,0 +1,36 @@
+== Bettermap
+Status: *Experimental*
+
+Bettermap is called bettermap for lack of a better name. Bettermap uses geographic coordinates to
+create clusters of markers on map and shade them orange, yellow and green depending on the
+density of the cluster.
+
+To drill down, click on a cluster. The map will be zoomed and the cluster broken into smaller cluster.
+When it no longer makes visual sense to cluster, individual markers will be displayed. Hover over
+a marker to see the tooltip value/
+
+IMPORTANT: bettermap requires an internet connection to download its map panels.
+// src/app/panels/bettermap/module.js:5
+
+=== Parameters
+
+field:: The field that contains the coordinates, in geojson format. GeoJSON is
++[longitude,latitude]+ in an array. This is different from most implementations, which use
+latitude, longitude.
+// src/app/panels/bettermap/module.js:62
+
+size:: The number of documents to use when drawing the map
+// src/app/panels/bettermap/module.js:70
+
+spyable:: Should the `inspect` icon be shown?
+// src/app/panels/bettermap/module.js:74
+
+tooltip:: Which field to use for the tooltip when hovering over a marker
+// src/app/panels/bettermap/module.js:78
+
+==== Queries
+queries object:: This object describes the queries to use on this panel.
+queries.mode::: Of the queries available, which to use. Options: +all, pinned, unpinned, selected+
+queries.ids::: In +selected+ mode, which query ids are selected.
+// src/app/panels/bettermap/module.js:82
+

docs/kibana/panels/column.asciidoc

@@ -0,0 +1,14 @@
+== Column
+Status: *Stable*
+
+A pseudo panel that lets you add other panels to be arranged in a column with defined heights.
+While the column panel is stable, it does have many limitations, including the inability to drag
+and drop panels within its borders. It may be removed in a future release.
+
+// src/app/panels/column/module.js:5
+
+=== Parameters
+
+panel:: An array of panel objects
+// src/app/panels/column/module.js:36
+

docs/kibana/panels/histogram.asciidoc

@@ -0,0 +1,129 @@
+== Histogram
+Status: *Stable*
+
+The histogram panel allow for the display of time charts. It includes several modes and tranformations
+to display event counts, mean, min, max and total of numeric fields, and derivatives of counter
+fields.
+
+// src/app/panels/histogram/module.js:5
+
+=== Parameters
+==== Axis options
+mode:: Value to use for the y-axis. For all modes other than count, +value_field+ must be
+defined. Possible values: count, mean, max, min, total.
+// src/app/panels/histogram/module.js:65
+
+time_field:: x-axis field. This must be defined as a date type in Elasticsearch.
+// src/app/panels/histogram/module.js:72
+
+value_field:: y-axis field if +mode+ is set to mean, max, min or total. Must be numeric.
+// src/app/panels/histogram/module.js:76
+
+x-axis:: Show the x-axis
+// src/app/panels/histogram/module.js:80
+
+y-axis:: Show the y-axis
+// src/app/panels/histogram/module.js:84
+
+scale:: Scale the y-axis by this factor
+// src/app/panels/histogram/module.js:88
+
+y_format:: 'none','bytes','short '
+// src/app/panels/histogram/module.js:92
+
+==== Annotations
+annotate object:: A query can be specified, the results of which will be displayed as markers on
+the chart. For example, for noting code deploys.
+annotate.enable::: Should annotations, aka markers, be shown?
+annotate.query::: Lucene query_string syntax query to use for markers.
+annotate.size::: Max number of markers to show
+annotate.field::: Field from documents to show
+annotate.sort::: Sort array in format [field,order], For example [`@timestamp',`desc']
+// src/app/panels/histogram/module.js:115
+
+==== Interval options
+auto_int:: Automatically scale intervals?
+// src/app/panels/histogram/module.js:132
+
+resolution:: If auto_int is true, shoot for this many bars.
+// src/app/panels/histogram/module.js:137
+
+interval:: If auto_int is set to false, use this as the interval.
+// src/app/panels/histogram/module.js:141
+
+interval:: Array of possible intervals in the *View* selector. Example [`auto',`1s',`5m',`3h']
+// src/app/panels/histogram/module.js:145
+
+==== Drawing options
+lines:: Show line chart
+// src/app/panels/histogram/module.js:149
+
+fill:: Area fill factor for line charts, 1-10
+// src/app/panels/histogram/module.js:154
+
+linewidth:: Weight of lines in pixels
+// src/app/panels/histogram/module.js:158
+
+points:: Show points on chart
+// src/app/panels/histogram/module.js:162
+
+pointradius:: Size of points in pixels
+// src/app/panels/histogram/module.js:166
+
+bars:: Show bars on chart
+// src/app/panels/histogram/module.js:170
+
+stack:: Stack multiple series
+// src/app/panels/histogram/module.js:174
+
+spyable:: Show inspect icon
+// src/app/panels/histogram/module.js:178
+
+zoomlinks:: Show `Zoom Out' link
+// src/app/panels/histogram/module.js:182
+
+options:: Show quick view options section
+// src/app/panels/histogram/module.js:186
+
+legend:: Display the legond
+// src/app/panels/histogram/module.js:190
+
+show_query:: If no alias is set, should the query be displayed?
+// src/app/panels/histogram/module.js:194
+
+interactive:: Enable click-and-drag to zoom functionality
+// src/app/panels/histogram/module.js:198
+
+legend_counts:: Show counts in legend
+// src/app/panels/histogram/module.js:202
+
+==== Transformations
+timezone:: Correct for browser timezone?. Valid values: browser, utc
+// src/app/panels/histogram/module.js:206
+
+percentage:: Show the y-axis as a percentage of the axis total. Only makes sense for multiple
+queries
+// src/app/panels/histogram/module.js:211
+
+zerofill:: Improves the accuracy of line charts at a small performance cost.
+// src/app/panels/histogram/module.js:216
+
+derivative:: Show each point on the x-axis as the change from the previous point
+// src/app/panels/histogram/module.js:220
+
+tooltip object::
+tooltip.value_type::: Individual or cumulative controls how tooltips are display on stacked charts
+tooltip.query_as_alias::: If no alias is set, should the query be displayed?
+// src/app/panels/histogram/module.js:224
+
+grid object:: Min and max y-axis values
+grid.min::: Minimum y-axis value
+grid.max::: Maximum y-axis value
+// src/app/panels/histogram/module.js:96
+
+==== Queries
+queries object:: This object describes the queries to use on this panel.
+queries.mode::: Of the queries available, which to use. Options: +all, pinned, unpinned, selected+
+queries.ids::: In +selected+ mode, which query ids are selected.
+// src/app/panels/histogram/module.js:105
+

docs/kibana/panels/hits.asciidoc

@@ -0,0 +1,37 @@
+== Hits
+Status: *Stable*
+
+The hits panel displays the number of hits for each of the queries on the dashboard in a
+configurable format specified by the `chart' property.
+
+// src/app/panels/hits/module.js:5
+
+=== Parameters
+
+arrangement:: The arrangement of the legend. horizontal or vertical
+// src/app/panels/hits/module.js:49
+
+chart:: bar, pie or none
+// src/app/panels/hits/module.js:55
+
+counter_pos:: The position of the legend, above or below
+// src/app/panels/hits/module.js:59
+
+donut:: If the chart is set to pie, setting donut to true will draw a hole in the midle of it
+// src/app/panels/hits/module.js:63
+
+tilt:: If the chart is set to pie, setting tilt to true will tilt it back into an oval
+// src/app/panels/hits/module.js:67
+
+labels:: If the chart is set to pie, setting labels to true will draw labels in the slices
+// src/app/panels/hits/module.js:71
+
+spyable:: Setting spyable to false disables the inspect icon.
+// src/app/panels/hits/module.js:75
+
+==== Queries
+queries object:: This object describes the queries to use on this panel.
+queries.mode::: Of the queries available, which to use. Options: +all, pinned, unpinned, selected+
+queries.ids::: In +selected+ mode, which query ids are selected.
+// src/app/panels/hits/module.js:79
+

docs/kibana/panels/map.asciidoc

@@ -0,0 +1,32 @@
+== Map
+Status: *Stable*
+
+The map panel translates 2 letter country or state codes into shaded regions on a map. Currently
+available maps are world, usa and europe.
+
+// src/app/panels/map/module.js:5
+
+=== Parameters
+
+map:: Map to display. world, usa, europe
+// src/app/panels/map/module.js:48
+
+colors:: An array of colors to use to shade the map. If 2 colors are specified, shades
+between them will be used. For example [`#A0E2E2', `#265656']
+// src/app/panels/map/module.js:54
+
+size:: Max number of regions to shade
+// src/app/panels/map/module.js:59
+
+exclude:: exclude this array of regions. For example [`US',`BR',`IN']
+// src/app/panels/map/module.js:63
+
+spyable:: Setting spyable to false disables the inspect icon.
+// src/app/panels/map/module.js:67
+
+==== Queries
+queries object:: This object describes the queries to use on this panel.
+queries.mode::: Of the queries available, which to use. Options: +all, pinned, unpinned, selected+
+queries.ids::: In +selected+ mode, which query ids are selected.
+// src/app/panels/map/module.js:71
+