diff --git a/examples/remoteBuild.md b/examples/remoteBuild.md
index ea86e28aa..bd3e77717 100644
--- a/examples/remoteBuild.md
+++ b/examples/remoteBuild.md
@@ -1,5 +1,7 @@
 # remote targets
 
+## remote directories
+
 `kustomize build` can be run on a URL. Resources can also reference other
 kustomization directories via URLs too.
 
@@ -24,6 +26,11 @@ SSH clones are also supported either with `git@github.com:owner/repo` or
 
 `file:///` clones are not supported.
 
+## remote files
+Resources can reference remote files via their raw GitHub urls, such
+as `https://raw.githubusercontent.com/kubernetes-sigs/kustomize/8ea501347443c7760217f2c1817c5c60934cf6a5/examples/helloWorld/deployment.yaml`
+.
+
 # Examples
 
 To try this immediately, run a build against the kustomization