Title is a bit long. Let's add an abbreviated title so the TOC is cleaner. It's good to mention "Beat" in the heading for SEO, but not necessary in the TOC where the context is clear.

== Creating New Kibana Dashboards for a Beat or Beat module

++++
<titleabbrev>Creating New Kibana Dashboards</titleabbrev>
++++

done

I'd remove line 4 and work some of the details into this section by saying:

When contributing to Beats development, you may want to add new dashboards or
customize the existing ones. To get started, you can
<<import-dashboards,import the Kibana dashboards>> that come with the official
Beats and use them as a starting point for your own dashboards. When you're done
making changes to the dashboards in Kibana, you can use the `export_dashboards`
script to <<export-dashboards,export the dashboards>>, along with all
dependencies, to a local directory.

done

The ideas seem a bit out of sequence here. To fix this:

• Move line 4 to the topic about importing dashboards (see my comments later).
• Make the changes recommended on line 6.

Move the content from line 4 to the start of this section. One small concern I have is that users might look furtively on the download page for an executable called "Beat". So I'd suggest a minor change:

The official Beats come with Kibana dashboards, and starting with 6.0.0, they
are part of every Beat package. You can use the Beat executable to import all
the dashboards and the index pattern for a Beat, including the dependencies
such as visualizations and searches.

done

Make this active to avoid passive voice:

To import the dashboards, run the setup command:

done

Change to:

The default value is the `kibana` directory available in the Beat package.

done

Change to: "...it's better to modify a copy of the dashboard because the Beat overwrites..."

done

Users might be confused if we use "generated" to mean a two different things in the same sentence. Maybe it would be better to say:

The Beat index pattern is generated from the `fields.yml`, which contains all
the fields exported by the Beat.

done

Is there a thought missing at the end of this sentence? There is no period, and it just seems to drop off.

done, thanks.

To get the correct note formatting, use NOTE: (a single colon). Otherwise, you won't get the correct formatting and icon. (There are multiple instances of NOTE:: that need to be fixed.)

done