From 65d65660c92a1c1d9add7af9f6aaaf38226b1430 Mon Sep 17 00:00:00 2001
From: Dakota Schneider <dakota.schneider@puppet.com>
Date: Tue, 5 Jun 2018 13:24:28 -0700
Subject: [PATCH] (BKR-1472) Document the .gitignore

Reorganizes the .gitignore and adds comments where appropriate.
---
 .gitignore | 41 ++++++++++++++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 9 deletions(-)

diff --git a/.gitignore b/.gitignore
index b055811052..4dd4d76a2c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,20 +1,46 @@
-*.swp
-log/*
 !.gitignore
+
+# Gem structure
 junit
 acceptance-tests
 pkg
 Gemfile.lock
-options.rb
+
+# Beaker-generated & local testing
 test.cfg
+options.rb
+merged_options.rb
+tmp/
+log/
+sut-files.tgz
+
+# YARD
 .yardoc
 yard_docs
-coverage
+doc
+
+# Dependencies
+# NOTE: For consistency, please use `vendor/bundle` for Bundler-installed dependencies
 .bundle
 .vendor
 _vendor
-tmp/
-doc
+vendor
+
+# Byebug
+.byebugrc
+.byebug_history
+
+# SimpleCov
+coverage
+
+
+#
+# Editor/IDE Clutter
+#
+# (TODO: consider removing these; use local personal .gitignore instead)
+
+# Vim
+*.swp
 # JetBrains IDEA
 *.iml
 .idea/
@@ -24,6 +50,3 @@ doc
 # Vagrant folder
 .vagrant/
 .vagrant_files/
-# Byebug
-.byebugrc
-.byebug_history