diff --git a/docs/developer/plugin-list.asciidoc b/docs/developer/plugin-list.asciidoc
index ee999b8df613f..0cb06f86f7faa 100644
--- a/docs/developer/plugin-list.asciidoc
+++ b/docs/developer/plugin-list.asciidoc
@@ -66,8 +66,8 @@ This API doesn't support angular, for registering angular dev tools, bootstrap a
 |Embeddables are re-usable widgets that can be rendered in any environment or plugin. Developers can embed them directly in their plugin. End users can dynamically add them to any embeddable containers.
 
 
-|{kib-repo}blob/{branch}/src/plugins/es_ui_shared[esUiShared]
-|WARNING: Missing README.
+|{kib-repo}blob/{branch}/src/plugins/es_ui_shared/README.md[esUiShared]
+|This plugin contains reusable code in the form of self-contained modules (or libraries). Each of these modules exports a set of functionality relevant to the domain of the module.
 
 
 |{kib-repo}blob/{branch}/src/plugins/expressions/README.md[expressions]
@@ -259,8 +259,9 @@ routes, etc.
 |WARNING: Missing README.
 
 
-|{kib-repo}blob/{branch}/x-pack/plugins/beats_management[beats_management]
-|WARNING: Missing README.
+|{kib-repo}blob/{branch}/x-pack/plugins/beats_management/readme.md[beatsManagement]
+|Notes:
+Failure to have auth enabled in Kibana will make for a broken UI. UI-based errors not yet in place
 
 
 |{kib-repo}blob/{branch}/x-pack/plugins/canvas/README.md[canvas]
@@ -353,8 +354,8 @@ or dashboards from the Kibana instance, from both server and client-side plugins
 Index Management by running this series of requests in Console:
 
 
-|{kib-repo}blob/{branch}/x-pack/plugins/index_management[indexManagement]
-|WARNING: Missing README.
+|{kib-repo}blob/{branch}/x-pack/plugins/index_management/README.md[indexManagement]
+|Create a data stream using Console and you'll be able to view it in the UI:
 
 
 |{kib-repo}blob/{branch}/x-pack/plugins/infra/README.md[infra]