From 95a2c74f1224547837ee301a57f1f9b2c71f6e47 Mon Sep 17 00:00:00 2001
From: Jashank Jeremy <jashank@rulingia.com>
Date: Wed, 5 Feb 2014 10:30:49 +1100
Subject: [PATCH] Document site cleanup behaviour.

As per #2014, document the fact that the destination directory is
'cleaned up', such that "obsolete" files (files which do not have a
known input Page, Post or StaticFile) are deleted, when a site is
rebuilt.

Resolves #2014.
[ci skip]
---
 site/docs/usage.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/site/docs/usage.md b/site/docs/usage.md
index 6db3a112..2891dc07 100644
--- a/site/docs/usage.md
+++ b/site/docs/usage.md
@@ -24,6 +24,18 @@ $ jekyll build --watch
 #    watched for changes, and regenerated automatically.
 {% endhighlight %}
 
+<div class="note warning">
+  <h5>Destination folders are cleaned on site builds</h5>
+  <p>
+    Be aware that the contents of the <code>&lt;destination&gt;</code>
+    folder are automatically cleaned when the site is built.  Files or
+    folders that are not created by your site will be removed.  Do not
+    use an important location for <code>&lt;destination&gt;</code>;
+    instead, use it as a staging area and copy files from there to
+    your web server. 
+  </p>
+</div>
+
 Jekyll also comes with a built-in development server that will allow you to
 preview what the generated site will look like in your browser locally.