diff --git a/libnm-util/nm-setting-template.c b/libnm-util/nm-setting-template.c
index 379289bffa..c100df3881 100644
--- a/libnm-util/nm-setting-template.c
+++ b/libnm-util/nm-setting-template.c
@@ -1,5 +1,11 @@
 /* -*- Mode: C; tab-width: 5; indent-tabs-mode: t; c-basic-offset: 5 -*- */
 
+/* This file is just a template - it's not built nor included in the tarball.
+   It's sole purpose is to make the process of creating new settings easier.
+   Just replace 'template' with new setting name (preserving the case),
+   remove this comment, and you're almost done.
+*/
+
 #include "nm-setting-template.h"
 
 G_DEFINE_TYPE (NMSettingTemplate, nm_setting_template, NM_TYPE_SETTING)
diff --git a/libnm-util/nm-setting-template.h b/libnm-util/nm-setting-template.h
index 7e3dde3885..0e1ab6c5da 100644
--- a/libnm-util/nm-setting-template.h
+++ b/libnm-util/nm-setting-template.h
@@ -1,5 +1,11 @@
 /* -*- Mode: C; tab-width: 5; indent-tabs-mode: t; c-basic-offset: 5 -*- */
 
+/* This file is just a template - it's not built nor included in the tarball.
+   It's sole purpose is to make the process of creating new settings easier.
+   Just replace 'template' with new setting name (preserving the case),
+   remove this comment, and you're almost done.
+*/
+
 #ifndef NM_SETTING_TEMPLATE_H
 #define NM_SETTING_TEMPLATE_H