diff --git a/gists.org b/gists.org
index 3eec3ee..041ebb1 100644
--- a/gists.org
+++ b/gists.org
@@ -34,6 +34,11 @@ Put this in ~/.termux/termux.properties for a better Emacs experience inside Ter
 :END:
 
 #+begin_src elisp :tangle gists/use-package-nesting.el
+  ;; Demonstrate that use-package allows for nesting configurations,
+  ;; although it is done semantically rather than syntactically. The
+  ;; :after keyword makes sure that the 'bar' package is only evaluated
+  ;; after the 'foo' package was loaded.
+
   (use-package foo)
 
   ;; only loads after foo has been loaded
diff --git a/gists/use-package-nesting.el b/gists/use-package-nesting.el
index 278f7e9..43721ea 100644
--- a/gists/use-package-nesting.el
+++ b/gists/use-package-nesting.el
@@ -1,3 +1,8 @@
+;; Demonstrate that use-package allows for nesting configurations,
+;; although it is done semantically rather than syntactically. The
+;; :after keyword makes sure that the 'bar' package is only evaluated
+;; after the 'foo' package was loaded.
+
 (use-package foo)
 
 ;; only loads after foo has been loaded