diff --git a/local.d/README b/local.d/README
index d3c11566..352847b4 100644
--- a/local.d/README
+++ b/local.d/README
@@ -7,3 +7,8 @@ executable and it has a .stop extension, it will be run when the local
 service is stopped.
 
 All files are processed in lexical order.
+
+Keep in mind that files in this directory are processed sequencially,
+and the local service is not considered started or stopped until
+everything is processed, so if you have a process which takes a long
+time to run, it can delay your boot or shutdown processing.