Add docs for apt-lists bucket

docs/buckets/apt-lists.md

@@ -0,0 +1,18 @@
+# APT lists
+
+Used by Debian-like Linux distros, will get configured under guest's `/var/lib/apt/lists`.
+
+As explained on [Wikipedia](http://en.wikipedia.org/wiki/Advanced_Packaging_Tool#Files),
+`/var/lib/apt/lists` is the "storage area for state information for each package
+resource specified in sources.list". By enabling this bucket, `apt` will be able
+to install cached packages without hitting the remote repositories for the main
+package lists, [being particularly useful when developing offline](https://github.com/fgrehm/vagrant-cachier/pull/84#issue-27311414).
+
+To manually enable it:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.vm.box = 'some-debian-box'
+  config.cache.enable :apt_lists
+end
+```

docs/template.html

@@ -83,6 +83,7 @@
                 <a class="dropdown-toggle" data-toggle="dropdown" href="#">Available Buckets <span class="caret"></span></a>
                 <ul class="dropdown-menu">
                   <li><a tabindex="-1" href="buckets/apt">APT</a></li>
+                  <li><a tabindex="-1" href="buckets/apt-lists">apt-lists</a></li>
                   <li><a tabindex="-1" href="buckets/apt-cacher">apt-cacher</a></li>
                   <li><a tabindex="-1" href="buckets/chef">Chef</a></li>
                   <li><a tabindex="-1" href="buckets/composer">Composer</a></li>