Set default overwrite_arrays option to true. Updated documentation

Author: Piotr Kuczynski

CHANGELOG.md

@@ -1,7 +1,8 @@
 # Changelog
 
-## ...
+## 1.3.0
 
+* **WARNING:** Overwrite arrays found in previously loaded settings file ([#137](https://github.com/railsconfig/config/pull/137) thanks to [@Fryguy](https://github.com/Fryguy) and [@dtaniwaki](https://github.com/dtaniwaki)) - this is a change breaking previous behaviour. If you want to keep Config to work as before, which is merging arrays found in following loaded settings file, please add `config.overwrite_arrays = true` to your Config initializer 
 * Changed default ENV variables loading settings to downcase variable names and parse values
 * Added parsing ENV variables values to Float type
 * Change method definition order in Rails integration module to prevent undefined method `preload` error (based on [@YaroSpace](https://github.com/YaroSpace) suggestion in [#111](https://github.com/railsconfig/config/issues/111)

README.md

@@ -253,8 +253,7 @@ located at `config/initializers/config.rb`.
 ### Merge customization
 
 * `knockout_prefix` - ability to remove elements of the array set in earlier loaded settings file. Default: `nil`
-
-* `overwrite_arrays` - ability to replace an entire array set in earlier loaded settings file. Default: `false`
+* `overwrite_arrays` - overwrite arrays found in previously loaded settings file. Default: `true`
 
 Check [Deep Merge](https://github.com/danielsdeleo/deep_merge) for more details.
 

lib/config.rb

@@ -22,7 +22,7 @@ module Config
   # deep_merge options
   mattr_accessor :knockout_prefix, :overwrite_arrays
   @@knockout_prefix = nil
-  @@overwrite_arrays = false
+  @@overwrite_arrays = true
 
   def self.setup
     yield self if @@_ran_once == false

lib/generators/config/templates/config.rb

@@ -6,6 +6,10 @@
   #
   # config.knockout_prefix = nil
 
+  # Overwrite arrays found in previously loaded settings file. When set to `false`, arrays will be merged.
+  #
+  # config.overwrite_arrays = true
+
   # Load environment variables from the `ENV` object and override any settings defined in files.
   #
   # config.use_env = false