diff --git a/demo/pwa/ServiceWorker.lpr b/demo/pwa/ServiceWorker.lpr
index 24cd755..4e76490 100644
--- a/demo/pwa/ServiceWorker.lpr
+++ b/demo/pwa/ServiceWorker.lpr
@@ -6,7 +6,8 @@ uses
   Classes, ServiceWorkerApp;
 
 const
-  YourCacheName = 'v6';
+  YourCacheName = 'v6'; // usually increased with every version
+   // The cache is specific to your domain, so no need to include your app name.
 
 type
 
diff --git a/packages/fcl-base/serviceworkerapp.pas b/packages/fcl-base/serviceworkerapp.pas
index 09c8c70..b32ea74 100644
--- a/packages/fcl-base/serviceworkerapp.pas
+++ b/packages/fcl-base/serviceworkerapp.pas
@@ -1,3 +1,7 @@
+{
+  A service worker functions like a proxy server, allowing to modify requests
+  and responses, and replace them with items from its own cache, and more.
+}
 unit ServiceWorkerApp;
 
 {$mode objfpc}