chewy 0.10.1 → 7.0.0

data/CHANGELOG.md

@@ -1,276 +1,269 @@
-# master
+# Changelog
 
-# Version 0.10.1
+## master (unreleased)
 
-## Changes
+### New Features
 
-  * Improved parallel worker titles (#558)
+### Changes
 
-## Bugfixes
+### Bugs Fixed
 
-  * Fixed request strategy initial debug message (#557)
+## 7.0.0 (2021-02-22)
 
-  * Fixed will objects paginated array initialization when pagination was not used (#556)
+### New Features
 
-  * Fixed fields symbol/string value (#555)
+  * [#763](https://github.com/toptal/chewy/pull/763): Added support for Elasticsearch 7 ([@rabotyaga][])
 
-  * Fixed root field value proc (#554)
+### Changes
 
-# Version 0.10.0
+  * [#757](https://github.com/toptal/chewy/pull/757): **(Breaking)** Fix `Chewy::Index.index` & `Chewy::Index.aliases` to correctly report indexes and aliases ([@mpeychich][], [@dalthon][])
+  * [#761](https://github.com/toptal/chewy/pull/761): Avoid fetching scope data to check if it is blank ([@dalthon][])
 
-## Breaking changes
+## 6.0.0 (2021-02-11)
 
-  * Changed behavior of `Chewy::Index.index_name`, it doesn't cache the values anymore.
-
-  * Journal interfaces, related code and rake tasks were completely refactored and are not compatible with the previous version.
+### Changes
 
-## Changes
-
-  * Less noisy strategies logging (@Borzik, #543)
-
-  * Parallel import and the corresponding rake tasks.
+  * [#743](https://github.com/toptal/chewy/pull/743): **(Breaking)** Elasticsearch 6.x support added. See the [migration guide](migration_guide.md) & ES [breaking changes](https://www.elastic.co/guide/en/elasticsearch/reference/6.8/breaking-changes-6.0.html). Removed legacy DSL support. Removed support for ES < 5. ([@mrzasa][], [@konalegi][], [@rabotyaga][])
+  * [#751](https://github.com/toptal/chewy/pull/751): Add [Multi Search API](https://www.elastic.co/guide/en/elasticsearch/reference/6.8/search-multi-search.html) support. ([@mpeychich][], [@dalthon][])
+  * [#755](https://github.com/toptal/chewy/pull/755): `attribute_highlights` returns an array of highlights. ([@musaffa][], [@dalthon][])
+  * [#753](https://github.com/toptal/chewy/pull/753): Add support for direct_import parameter to skip objects reloading. ([@TikiTDO][], [@dalthon][])
+  * [#739](https://github.com/toptal/chewy/pull/739): Remove explicit `main` branch dependencies on `rspec-*` gems after `rspec-mocks` 3.10.2 is released. ([@rabotyaga][])
 
-  * `:shoryuken` async strategy (@josephchoe, #532)
+### Bugs Fixed
 
-  * Deprecate `Chewy::Index.build_index_name`.
+* [#695](https://github.com/toptal/chewy/pull/695): Clear the scroll by id after completing `scroll_batches`. ([@socialchorus][])
+* [#749](https://github.com/toptal/chewy/pull/749): Avoid importing everything when given an empty relation. ([@JF-Lalonde][], [@dalthon][])
+* [#736](https://github.com/toptal/chewy/pull/736): Fix nil children when using witchcraft. ([@taylor-au][])
 
-  * Rename `Chewy::Index.default_prefix` to `Chewy::Index.prefix`. The old one is deprecated.
+## 5.2.0 (2021-01-28)
 
-  * Add `Chewy::Type.derivable_name` for consistency.
+### Changes
 
-  * Rename `Chewy::Index.derivable_index_name` to `Chewy::Index.derivable_name`.
-    `Chewy::Index.derivable_index_name` and `Chewy::Type.derivable_index_name` are deprecated.
+  * [#734](https://github.com/toptal/chewy/pull/734): Add support for Ruby 3. ([@lowang][])
+  * [#735](https://github.com/toptal/chewy/pull/735): Correct deprecation warning for Elasticsearch 5.6 to 6: empty query for`_delete_by_query`, delete by alias, `index_already_exists_exception` renaming. ([@bhacaz][])
+  * [#733](https://github.com/toptal/chewy/pull/733): Update gemspec dependencies for Rails. Update CI gemfiles and matrix to tests against current LTS Rails versions. ([@bhacaz][])
+  * Tweak some wording and formatting; add a note about compatibility; update copyright; remove broken logo; update the CI badge. ([@bbatsov][])
+  * [#714](https://github.com/toptal/chewy/pull/714): Update instructions for AWS ElasticSearch. ([@olancheg][])
+  * [#728](https://github.com/toptal/chewy/pull/728): Fix more ruby 2.7 keyword params deprecation warnings. ([@aglushkov][])
+  * [#715](https://github.com/toptal/chewy/pull/715): Fixed all deprecation warnings in Ruby 2.7. ([@gseddon][])
+  * [#718](https://github.com/toptal/chewy/pull/718): Added Ruby 2.7 to CircleCI config. ([@mrzasa][])
+  * [#707](https://github.com/toptal/chewy/pull/707): Allow configuration of Active Job queue name. ([@mrzasa][])
+  * [#711](https://github.com/toptal/chewy/pull/711): Setup CI on CircleCI. ([@mrzasa][])
+  * [#710](https://github.com/toptal/chewy/pull/710): Fix deprecation warning for constructing new `BigDecimal`. ([@AlexVPopov][])
 
-  * Use normal YAML loading, for the config, we don't need the safe one.
+## 5.1.0 (2019-09-24)
 
-  * `default_root_options` option (@barthez, #526)
+### Changes
 
-  * Partial indexing ability: it is possible to update only specified fields.
-
-  * New cool `rake chewy:deploy` task.
-
-  * Selective reset (resets only if necessary): `rake chewy:upgrade`.
-
-  * Consistency checks and synchronization: `rake chewy:sync`.
-
-  * Brand new request DSL. Supports ElasticSearch 2 and 5, better usability, architecture and docs.
-
-  * Add Kaminari 1.0 support.
+  * [#657](https://github.com/toptal/chewy/pull/657): **(Breaking)** Add support for multiple indices in request. ([@pyromaniac][])
+  * [#647](https://github.com/toptal/chewy/pull/647): **(Breaking)** Support `search_type`, `request_cache`, and `allow_partial_search_results` as query string parameters. ([@mattzollinhofer][])
+  * [#606](https://github.com/toptal/chewy/pull/606): Speed up imports when `bulk_size` is specified. ([@yahooguntu][])
+  * [#682](https://github.com/toptal/chewy/pull/682): Insert `RequestStrategy` middleware before `ActionDispatch::ShowExceptions`. ([@dck][])
 
-  * `skip_index_creation_on_import` option (@sergey-kintsel, #483)
+## 5.0.0 (2018-02-13)
 
-  * Ability to use procs for settings (@parallel588, #481)
+### Changes
 
-  * Bulk indexing optimizations with new additional options (@eproulx-petalmd, #467)
+  * **(Breaking)** Align the gem version with the most recent ElasticSearch version we support.
+  * **(Breaking)** `Chewy.default_field_type` is `text` now.
+  * **(Breaking)** `Chewy::Stash` was split onto two indexes - `Chewy::Stash::Specification` and `Chewy::Stash::Journal`.
+  * **(Breaking)** Data for journal and specification is stored in binary fields base64-encoded to bypass the limits of other fields.
+  * **(Breaking)** [#626](https://github.com/toptal/chewy/pull/626): Don't underscore suggested index name. ([@dm1try][])
+  * [#598](https://github.com/toptal/chewy/pull/598): `pipeline` import option support. ([@eManPrague][])
+  * [#625](https://github.com/toptal/chewy/pull/625): Proper Rails check. ([@nattfodd][])
+  * [#623](https://github.com/toptal/chewy/pull/623): Bypass strategy performance improvements. ([@DNNX][])
+  * [#620](https://github.com/toptal/chewy/pull/620): Avoid index update calls for empty data. ([@robertasg][])
+  * Do not underscore suggested index name on `Chewy::Index.index_name` call.
+  * It is possible now to call `root` method several times inside a single type definition, the options will be merged. Also, the block isn't required anymore.
+  * [#565](https://github.com/toptal/chewy/pull/565): Fixed some Sequel deprecation warnings. ([@arturtr][])
+  * [#577](https://github.com/toptal/chewy/pull/577): Fixed some Sequel deprecation warnings. ([@matchbookmac][])
 
-  * Configurable sidekiq options (@averell23, #438)
+### Bugs Fixed
 
-# Version 0.9.0
+  * [#593](https://github.com/toptal/chewy/pull/593): Fixed index settings logic error. ([@yahooguntu][])
+  * [#567](https://github.com/toptal/chewy/pull/567): Missed check in higlight method. ([@heartfulbird][])
 
-## Changes
+-----------------------------------------------------------------------------------
 
-  * Add `preference` param to Query (@menglewis, #443)
+## 0.10.1
 
-  * Add the `track_scores` option to the query; `_score` to be computed and tracked even when there are no `_score` in sort. (@dmitry, #417)
+### Changes
 
-  * Confugurable `Chewy.indices_path` (@robacarp, #414, #433, #439)
+  * [#558](https://github.com/toptal/chewy/pull/558): Improved parallel worker titles
 
-  * [Journaling](https://github.com/toptal/chewy/#journaling) implementation (@sergey-kintsel, #409, #425, #428, #432, #434, #463)
+### Bugs Fixed
 
-  * Minitest helpers (@robacarp, #396)
+  * [#557](https://github.com/toptal/chewy/pull/557): Fixed request strategy initial debug message
+  * [#556](https://github.com/toptal/chewy/pull/556): Fixed will objects paginated array initialization when pagination was not used
+  * [#555](https://github.com/toptal/chewy/pull/555): Fixed fields symbol/string value
+  * [#554](https://github.com/toptal/chewy/pull/554): Fixed root field value proc
 
-  * `Chewy::Query#unlimited` to fetch all the documents (@sergey-kintsel, #393)
+## 0.10.0
 
-  * `Chewy::Query#exists?` (@sergey-kintsel, #386)
+### Breaking changes
 
-  * Import otimizations (#381, #376)
-
-  * Additional import optimization technique - [raw import](https://github.com/toptal/chewy/#raw-import) (@DNNX, #375)
+  * Changed behavior of `Chewy::Index.index_name`, it doesn't cache the values anymore.
+  * Journal interfaces, related code and rake tasks were completely refactored and are not compatible with the previous version.
 
-  * `weight` scoring dunction was added to the search DSL (@sevab, #380)
+### Changes
 
+  * [#543](https://github.com/toptal/chewy/pull/543): Less noisy strategies logging ([@Borzik][])
+  * Parallel import and the corresponding rake tasks.
+  * [#532](https://github.com/toptal/chewy/pull/532): `:shoryuken` async strategy ([@josephchoe][])
+  * Deprecate `Chewy::Index.build_index_name`.
+  * Rename `Chewy::Index.default_prefix` to `Chewy::Index.prefix`. The old one is deprecated.
+  * Add `Chewy::Type.derivable_name` for consistency.
+  * Rename `Chewy::Index.derivable_index_name` to `Chewy::Index.derivable_name`.
+    `Chewy::Index.derivable_index_name` and `Chewy::Type.derivable_index_name` are deprecated.
+  * Use normal YAML loading, for the config, we don't need the safe one.
+  * [#526](https://github.com/toptal/chewy/pull/526): `default_root_options` option ([@barthez][])
+  * Partial indexing ability: it is possible to update only specified fields.
+  * New cool `rake chewy:deploy` task.
+  * Selective reset (resets only if necessary): `rake chewy:upgrade`.
+  * Consistency checks and synchronization: `rake chewy:sync`.
+  * Brand new request DSL. Supports ElasticSearch 2 and 5, better usability, architecture and docs.
+  * Add Kaminari 1.0 support.
+  * [#483](https://github.com/toptal/chewy/pull/483): `skip_index_creation_on_import` option ([@sergey-kintsel][])
+  * [#481](https://github.com/toptal/chewy/pull/481): Ability to use procs for settings ([@parallel588][])
+  * [#467](https://github.com/toptal/chewy/pull/467): Bulk indexing optimizations with new additional options ([@eproulx-petalmd][])
+  * [#438](https://github.com/toptal/chewy/pull/438): Configurable sidekiq options ([@averell23][])
+
+## 0.9.0
+
+### Changes
+
+  * [#443](https://github.com/toptal/chewy/pull/443): Add `preference` param to Query ([@menglewis][])
+  * [#417](https://github.com/toptal/chewy/pull/417): Add the `track_scores` option to the query; `_score` to be computed and tracked even when there are no `_score` in sort. ([@dmitry][])
+  * [#414](https://github.com/toptal/chewy/pull/414), [#433](https://github.com/toptal/chewy/pull/433), [#439](https://github.com/toptal/chewy/pull/439): Confugurable `Chewy.indices_path` ([@robacarp][])
+  * [#409](https://github.com/toptal/chewy/pull/409), [#425](https://github.com/toptal/chewy/pull/425), [#428](https://github.com/toptal/chewy/pull/428), [#432](https://github.com/toptal/chewy/pull/432), [#434](https://github.com/toptal/chewy/pull/434), [#463](https://github.com/toptal/chewy/pull/463): [Journaling](https://github.com/toptal/chewy/#journaling) implementation ([@sergey-kintsel][])
+  * [#396](https://github.com/toptal/chewy/pull/396): Minitest helpers ([@robacarp][])
+  * [#393](https://github.com/toptal/chewy/pull/393): `Chewy::Query#unlimited` to fetch all the documents ([@sergey-kintsel][])
+  * [#386](https://github.com/toptal/chewy/pull/386): `Chewy::Query#exists?` ([@sergey-kintsel][])
+  * [#381](https://github.com/toptal/chewy/pull/381), [#376](https://github.com/toptal/chewy/pull/376): Import otimizations
+  * [#375](https://github.com/toptal/chewy/pull/375): Additional import optimization technique - [raw import](https://github.com/toptal/chewy/#raw-import) ([@DNNX][])
+  * [#380](https://github.com/toptal/chewy/pull/380): `weight` scoring dunction was added to the search DSL ([@sevab][])
   * Rake tasks support multiple indexes and exceptions: `rake chewy:reset[users,projects]`, `rake chewy:update[-projects]`
-
   * Witchcraft™ supports dynamically generated procs with variables from closure.
+  * Added `Query#preference` for specifying shard replicas to query against. ([@menglewis][])
 
-  * Added `Query#preference` for specifying shard replicas to query against. (@menglewis)
+### Bugs Fixed
 
-## Bugfixes
+  * [#415](https://github.com/toptal/chewy/pull/415): `.script_fields` method in the Index class ([@dmitry][])
+  * [#398](https://github.com/toptal/chewy/pull/398): Fix routing_missing_exception on delete with parent missing ([@guigs][])
+  * [#385](https://github.com/toptal/chewy/pull/385): Sequel custom primary keys handling fix ([@okliv][])
+  * [#374](https://github.com/toptal/chewy/pull/374): Bulk import fixes ([@0x0badc0de][])
 
-  * `.script_fields` method in the Index class (@dmitry, #415)
+## 0.8.4
 
-  * Fix routing_missing_exception on delete with parent missing (@guigs, #398)
-
-  * Sequesl custom primary keys handling fix (@okliv, #385)
-
-  * Bulk import fixes (@0x0badc0de, #374)
-
-# Version 0.8.4
-
-## Changes
+### Changes
 
   * Brand new import `:bulk_size` option, set desired ElasticSearch bulk size in bytes
-
   * Witchcraft™ technology
-
-  * Configurable per-type default import options (@barthez, #341)
-
-  * Various codebase optimizations (@DNNX, @pyromaniac)
-
+  * [#341](https://github.com/toptal/chewy/pull/341): Configurable per-type default import options ([@barthez][])
+  * Various codebase optimizations ([@DNNX][], [@pyromaniac][])
   * `update_index` Rspec matcher messages improvements
-
   * `:all` rake tasks deprecation
-
-  * Scoped notification subscriptions in rake tasks (@0x0badc0de, #335)
-
-  * Async strategies workers accept options (@dnd, #321)
-
-  * Prefix is configurable per-index (@mikeyhogarth, #314)
-
-  * Ability to pass proc for transport configuration (@feymartynov, @reidab, #302, #339)
-
-  * ElasticSearch 2 support (@sergeygaychuk, #297)
-
+  * [#335](https://github.com/toptal/chewy/pull/335): Scoped notification subscriptions in rake tasks ([@0x0badc0de][])
+  * [#321](https://github.com/toptal/chewy/pull/321): Async strategies workers accept options ([@dnd][])
+  * [#314](https://github.com/toptal/chewy/pull/314): Prefix is configurable per-index ([@mikeyhogarth][])
+  * [#302](https://github.com/toptal/chewy/pull/302), [#339](https://github.com/toptal/chewy/pull/339): Ability to pass proc for transport configuration ([@feymartynov][], [@reidab][])
+  * [#297](https://github.com/toptal/chewy/pull/297): ElasticSearch 2 support ([@sergeygaychuk][])
   * Accessing types with methods is deprecated. Use `MyIndex::MyType` constant reference instead of `MyIndex.my_type` method.
+  * [#294](https://github.com/toptal/chewy/pull/294): Sequel adapter improvements ([@mrbrdo][])
 
-  * Sequel adapter improvements (@mrbrdo, #294)
-
-## Bugfixes
-
-  * Mongoid atomic strategy fix (#325)
+### Bugs Fixed
 
-  * Method missing fix (@jesjos, #324)
+  * [#325](https://github.com/toptal/chewy/pull/325): Mongoid atomic strategy fix
+  * [#324](https://github.com/toptal/chewy/pull/324): Method missing fix ([@jesjos][])
+  * [#319](https://github.com/toptal/chewy/pull/319): Hash fields composition fix ([@eproulx-petalmd][])
+  * [#306](https://github.com/toptal/chewy/pull/306): Better errors handling in strategies ([@barthez][])
+  * [#303](https://github.com/toptal/chewy/pull/303): Assets strategies silencer fix for Rails 5 API mode ([@clupprich][])
 
-  * Hash fields composition fix (@eproulx-petalmd, #319)
+## 0.8.3
 
-  * Better errors handling in strategies (@barthez, #306)
-
-  * Assets strategies silencer fix for Rails 5 API mode (@clupprich, #303)
-
-# Version 0.8.3
-
-## Breaking changes:
+### Breaking changes:
 
   * `Chewy.atomic` and `Chewy.urgent_update=` methods was removed from the codebase, use `Chewy.strategy` block instead.
-
   * `delete_from_index?` hook is removed from the codebase.
 
-## Changes
+### Changes
 
   * Sequel support completely reworked to use common ORM implementations + better sequel specs covarage.
 
-## Bugfixes
+### Bugs Fixed
 
   * Sequel objects transactional destruction fix
-
-  * Correct Rspec mocking framework checking (@mainameiz)
-
+  * Correct Rspec mocking framework checking ([@mainameiz][])
   * Atomic strategy is now compatible with custom ids proc.
+  * Safe unsubscribe on import ([@marshall-lee][])
+  * Correct custom assets path silencer ([@davekaro][])
 
-  * Safe unsubscribe on import (@marshall-lee)
-
-  * Correct custom assets path silencer (@davekaro)
-
-# Version 0.8.2
-
-## Changes
-
-  * ActiveJob strategy by @mkcode
-
-  * Async strategies tweak (@AndreySavelyev)
+## 0.8.2
 
-  * GeoPoint readme (@joonty)
+### Changes
 
-  * Multiple grammar fixes and code improvements (@biow0lf)
+  * ActiveJob strategy by [@mkcode][]
+  * Async strategies tweak ([@AndreySavelyev][])
+  * GeoPoint readme ([@joonty][])
+  * Multiple grammar fixes and code improvements ([@biow0lf][])
+  * Named aggregations by [@caldwecr][]
+  * Sequel adapter by [@jirutka][]
+  * Rake helper methods extracted ([@caldwecr][], [@jirutka][])
+  * Multiple grammar fixes ([@henrebotha][])
+  * Ability to pass a proc to `update_index` to define updating index dynamically ([@SeTeM][])
 
-  * Named aggregations by @caldwecr
-
-  * Sequel adapter by @jirutka
-
-  * Rake helper methods extracted (@caldwecr, @jirutka)
-
-  * Multiple grammar fixes (@henrebotha)
-
-  * Ability to pass a proc to `update_index` to define updating index dynamically (@SeTeM)
-
-
-## Bugfixes
+### Bugs Fixed
 
   * Fixed transport logger and tracer configuration
 
-# Version 0.8.1
+## 0.8.1
 
-## Bugfixes
+### Bugs Fixed
 
   * Added support of elasticsearch-ruby 1.0.10
 
-# Version 0.8.0
+## 0.8.0
 
-## Breaking changes:
+### Breaking changes:
 
   * `:atomic` and `:urgent` strategies are using `import!` method raising exceptions
 
-## Changes
+### Changes
 
   * Crutches™ technology
-
-  * Added `.script_fields` chainable method to query (@ka8725)
-
-  * `update_index` matcher mocha support (@lardawge)
-
+  * Added `.script_fields` chainable method to query ([@ka8725][])
+  * `update_index` matcher mocha support ([@lardawge][])
   * `:resque` async strategy
+  * `:sidekiq` async strategy (inspired by [@sharkzp][])
+  * Added `Query#search_type` for `search_type` request option setup ([@marshall-lee][])
 
-  * `:sidekiq` async strategy (inspired by @sharkzp)
-
-  * Added `Query#search_type` for `search_type` request option setup (@marshall-lee)
-
-## Bugfixes
+### Bugs Fixed
 
   * Rails 4.2 migrations are not raising UndefinedUpdateStrategy anymore on data updates
+  * Mongoid random failing specs fixes ([@marshall-lee][])
 
-  * Mongoid random failing specs fixes (@marshall-lee)
+## 0.7.0
 
-# Version 0.7.0
-
-## Breaking changes:
-
-  * `Chewy.use_after_commit_callbacks = false` returns previous RDBMS behavior
-  in tests
+### Breaking changes:
 
+  * `Chewy.use_after_commit_callbacks = false` returns previous RDBMS behavior in tests
   * ActiveRecord import is now called after_commit instead of after_save and after_destroy
-
   * Import now respects default scope and removes unmatched documents
-
   * `delete_from_index?` method is deprecated, use
-
     ```ruby
       define_type User, delete_if: ->{ removed? } do
         ...
       end
     ```
-
   * `Chewy.request_strategy` to configure action controller's request wrapping strategy
-
   * `Chewy.root_strategy` to configure the first strategy in stack
-
   * Default strategy for controller actions is `:atomic`
-
   * Default strategy for activerecord migrations is `:bypass`
-
   * Default strategy for sandbox console is `:bypass`
-
   * Default strategy for rails console is `:urgent`
-
   * `Chewy.configuration` was renamed to `Chewy.settings`
-
-  * Reworked index update strategies implementation. `Chewy.atomic`
-  and `Chewy.urgent_update` are now deprecated in favour of the new
-  `Chewy.strategy` API.
-
-  * Loading objects for object-sourced types using `wrap` method is
-  deprecated, `load_one` method should be used instead. Or method name
-  might be passed to `define_type`:
-
+  * Reworked index update strategies implementation. `Chewy.atomic` and `Chewy.urgent_update` are now deprecated in favour of the new `Chewy.strategy` API.
+  * Loading objects for object-sourced types using `wrap` method is deprecated, `load_one` method should be used instead. Or method name might be passed to `define_type`:
     ```ruby
       class GeoData
         def self.get_data(elasticsearch_document)
@@ -284,14 +277,11 @@
         end
     ```
 
-## Changes
-
-  * Multiple enhancements by @DNNX
-
-  * Added `script_fields` to search criteria (@ka8725)
+### Changes
 
+  * Multiple enhancements by [@DNNX][]
+  * Added `script_fields` to search criteria ([@ka8725][])
   * ORM adapters now completely relies on the default scope. This means every scope or objects passed to import are merged with default scope so basically there is no need to define `delete_if` block. Default scope strongly restricts objects which may land in the current index.
-
     ```ruby
       define_type Country.where("rating > 30") do
 
@@ -304,11 +294,7 @@
       CountriesIndex::Country.import(Country.where("rating < 50").to_a)
       CountriesIndex::Country.import(Country.where("rating < 50").pluck(:id))
     ```
-
-  * Object adapter supports custom initial import and load methods, so it
-  could be configured to be used with procs or any class responding to `call`
-  method.
-
+  * Object adapter supports custom initial import and load methods, so it could be configured to be used with procs or any class responding to `call` method.
     ```ruby
       class GeoData
         def self.call
@@ -321,9 +307,7 @@
           ...
         end
     ```
-
   * Nested fields value procs additional arguments: parent objects.
-
     ```ruby
       define_type Country do
         field :name
@@ -332,177 +316,133 @@
         end
       end
     ```
-
   * Implemented basic named scopes
 
-## Bugfixes
-
-  * `script_score` allow options (@joeljunstrom)
-
-  * Chewy indexes eaged loading fixes (@leemhenson)
+### Bugs Fixed
 
+  * `script_score` allow options ([@joeljunstrom][])
+  * Chewy indexes eaged loading fixes ([@leemhenson][])
   * `Chewy::Index.import nil` imports nothing instead of initial data
 
-# Version 0.6.2
-
-## Changes
+## 0.6.2
 
-  * document root id custom value option (@baronworks)
+### Changes
 
-## Bugfixes
+  * document root id custom value option ([@baronworks][])
 
-  * Removed decay function defaults (@Linuus)
+### Bugs Fixed
 
+  * Removed decay function defaults ([@Linuus][])
   * Correct config file handling in case of empty file
 
-# Version 0.6.1
+## 0.6.1
 
-## Changes
-
-  * `min_score` query option support (@jshirley)
+### Changes
 
+  * `min_score` query option support ([@jshirley][])
   * `Chewy::Query#find` method for finding documents by id
 
-# Version 0.6.0
-
-## Changes
+## 0.6.0
 
-  * Mongoid support YaY! (@fabiotomio, @leemhenson)
+### Changes
 
+  * Mongoid support YaY! ([@fabiotomio][], [@leemhenson][])
   * `urgent: true` option for `update_index` is deprecated and will be removed soon, use `Chewy.atomic` instead
+  * `timeout` and `timed_out` support ([@MarkMurphy][])
+  * will_paginate support ([@josecoelho][])
 
-  * `timeout` and `timed_out` support (@MarkMurphy)
-
-  * will_paginate support (@josecoelho)
+### Bugs Fixed
 
-## Bugfixes
+  * All the query chainable methods delegated to indexes and types (partially [@Linuus][])
 
-  * All the query chainable methods delegated to indexes and types (partially @Linuus)
+## 0.5.2
 
-# Version 0.5.2
-
-## Breaking changes:
+### Breaking changes:
 
   * `Chewy::Type::Base` removed in favour of using `Chewy::Type` as a base class for all types
 
-## Changes
+### Changes
 
   * `Chewy.massacre` aliased to `Chewy.delete_all` method deletes all the indexes with current prefix
 
-## Bugfixes:
-
-  * Advanced type classes resolving (@inbeom)
+### Bugs Fixed:
 
+  * Advanced type classes resolving ([@inbeom][])
   * `import` ignores nil
 
-# Version 0.5.1
-
-## Changes:
+## 0.5.1
 
-  * `chewy.yml` Rails generator (@jirikolarik)
-
-  * Parent-child mappings feature support (@inbeom)
+### Changes:
 
+  * `chewy.yml` Rails generator ([@jirikolarik][])
+  * Parent-child mappings feature support ([@inbeom][])
   * `Chewy::Index.total_count` and `Chewy::Type::Base.total_count`
+  * `Chewy::Type::Base.reset` method. Deletes all the type documents and performs import ([@jondavidford][])
+  * Added `Chewy::Query#delete_all` scope method using delete by query ES feature ([@jondavidford][])
+  * Rspec 3 `update_index` matcher support ([@jimmybaker][])
+  * Implemented function scoring ([@averell23][])
 
-  * `Chewy::Type::Base.reset` method. Deletes all the type documents and performs import (@jondavidford)
-
-  * Added `Chewy::Query#delete_all` scope method using delete by query ES feature (@jondavidford)
+### Bugs Fixed:
 
-  * Rspec 3 `update_index` matcher support (@jimmybaker)
+  * Indexed eager-loading fix ([@leemhenson][])
+  * Field type deriving nested type support fix ([@rschellhorn][])
 
-  * Implemented function scoring (@averell23)
+## 0.5.0
 
-## Bugfixes:
-
-  * Indexed eager-loading fix (@leemhenson)
-
-  * Field type deriving nested type support fix (@rschellhorn)
-
-# Version 0.5.0
-
-## Breaking changes:
+### Breaking changes:
 
   * 404 exception (IndexMissingException) while query is swallowed and treated like an empty result set.
-
   * `load` and `preload` for queries became lazy. Might be partially incompatible.
-
   * Changed mapping behavior: multi-fields are defined in conformity with ElasticSearch documentation (http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/_multi_fields.html#_multi_fields)
 
-## Changes:
-
-  * `suggest` query options support (@rschellhorn).
+### Changes:
 
+  * `suggest` query options support ([@rschellhorn][]).
   * Added hash data support. How it is possible to pass hashes to import.
-
   * `rake chewy:reset` and `rake chewy:update` paramless acts as `rake chewy:reset:all` and `rake chewy:update:all` respectively
-
   * Added `delete_from_index?` API method for custom deleted objects marking.
-
   * Added `post_filter` API, working the same way as filters.
-
   * Added chainable `strategy` query method.
-
   * Aliasing is performed in index create request for ElasticSearch >= 1.1.
-
   * `preload` scope method loads ORM/ODM objects in background.
-
   * `load` method `:only` and `:except` options to specify load types.
-
   * `highlight` and `rescore` query options support.
-
   * config/chewy.yml ERB support.
 
-## Bugfixes:
+### Bugs Fixed:
 
   * Fixed `missing` and `exists` filters DSL constructors.
-
   * Reworked index data composing.
-
-  * Support for Kaminari new PaginatableArray behavior (@leemhenson)
-
+  * Support for Kaminari new PaginatableArray behavior ([@leemhenson][])
   * Correct waiting for status. After index creation, bulk import, and deletion.
+  * [#23](https://github.com/toptal/chewy/pull/23): Fix "wrong constant name" with namespace models
 
-  * Fix #23 "wrong constant name" with namespace models
-
-# Version 0.4.0
+## 0.4.0
 
   * Changed `update_index` matcher behavior. Now it compare array attributes position-independently.
-
-  * Search aggregations API support (@arion).
-
+  * Search aggregations API support ([@arion][]).
   * Chewy::Query#facets called without params performs the request and returns facets.
-
   * Added `Type.template` DSL method for root objects dynamic templates definition. See [mapping.rb](lib/chewy/type/mapping.rb) for more details.
-
-  * ActiveRecord adapter custom `primary_key` support (@matthee).
-
+  * ActiveRecord adapter custom `primary_key` support ([@matthee][]).
   * Urgent update now clears association cache in ActiveRecord to ensure latest changes are imported.
-
   * `import` now creates index before performing.
-
   * `Chewy.configuration[:wait_for_status]` option. Can be set to `red`, `yellow` or `green`. If set - chewy will wait for cluster status before creating, deleting index and import. Useful for specs.
 
-# Version 0.3.0
+## 0.3.0
 
   * Added `Chewy.configuration[:index]` config to setup common indexes options.
-
   * `Chewy.client_options` replaced with `Chewy.configuration`
-
   * Using source filtering instead of fields filter (http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-request-source-filtering.html).
 
-# Version 0.2.3
+## 0.2.3
 
   * `.import!` indexes method, raises import errors.
-
   * `.import!` types method, raises import errors. Useful for specs.
 
-# Version 0.2.2
-
-  * Support for `none` scope (@undr).
-
-  * Auto-resolved analyzers and analyzers repository (@webgago):
+## 0.2.2
 
+  * Support for `none` scope ([@undr][]).
+  * Auto-resolved analyzers and analyzers repository ([@webgago][]):
     ```ruby
       # Setting up analyzers repository:
       Chewy.analyzer :title_analyzer, type: 'custom', filter: %w(lowercase icu_folding title_nysiis)
@@ -513,69 +453,42 @@
         settings analysis: {analyzer: ['title_analyzer', {one_more_analyzer: {type: 'custom', tokenizer: 'lowercase'}}]}
       end
     ```
-
     `title_analyzer` here will be automatically resolved and passed to index mapping
 
-# Version 0.2.0
+## 0.2.0
 
   * Reworked import error handling. Now all the import errors from ElasticSearch are handled properly, also import method returns true of false depending on the import process success.
-
   * `Chewy::Index.import` now takes types hash as argument within options hash:
 
     `PlacesIndex.import city: City.enabled, country: Country.enabled, refresh: false`
-
   * Old indexes cleanup after reset.
-
   * Added index prefixes.
-
   * `define_type` now takes options for adapter.
-
   * `chewy:reset` and `chewy:reset:all` rake tasks are now trying to reset index with zero downtime if it is possible.
-
   * Added `chewy:update:all` rake task.
-
   * Methods `.create`, `.create!`, `.delete`, `.delete`, `reset!` are now supports index name suffix passing as the first argument. See [actions.rb](lib/chewy/index/actions.rb) for more details.
-
   * Method `reset` renamed to `reset!`.
-
   * Added common loading scope for AR adapter. Also removed scope proc argument, now it executes just in main load scope context.
-
     `CitiesIndex.all.load(scope: {city: City.include(:country)})`
     `CitiesIndex.all.load(scope: {city: -> { include(:country) }})`
     `CitiesIndex.all.load(scope: ->{ include(:country) })`
 
-# Version 0.1.0
+## 0.1.0
 
   * Added filters simplified DSL. See [filters.rb](lib/chewy/query/filters.rb) for more details.
-
   * Queries and filters join system reworked. See [query.rb](lib/chewy/query.rb) for more details.
-
   * Added query `merge` method
-
-  * `update_index` matcher now wraps expected block in `Chewy.atomic` by default.
-    This behaviour can be prevented with `atomic: false` option passing
-
+  * `update_index` matcher now wraps expected block in `Chewy.atomic` by default. This behaviour can be prevented with `atomic: false` option passing
     ```ruby
       expect { user.save! }.to update_index('users#user', atomic: false)
     ```
-
   * Renamed `Chewy.observing_enabled` to `Chewy.urgent_update` with `false` as default
-
-  * `update_elasticsearch` renamed to `update_index`, added `update_index`
-    `:urgent` option
-
-  * Added import ActiveSupport::Notifications instrumentation
-    `ActiveSupport::Notifications.subscribe('import_objects.chewy') { |*args| }`
-
-  * Added `types!` and `only!` query chain methods, which purges previously
-    chained types and fields
-
+  * `update_elasticsearch` renamed to `update_index`, added `update_index` `:urgent` option
+  * Added import ActiveSupport::Notifications instrumentation `ActiveSupport::Notifications.subscribe('import_objects.chewy') { |*args| }`
+  * Added `types!` and `only!` query chain methods, which purges previously chained types and fields
   * `types` chain method now uses types filter
-
   * Added `types` query chain method
-
   * Changed types access API:
-
     ```ruby
       UsersIndex::User # => UsersIndex::User
       UsersIndex::types_hash['user'] # => UsersIndex::User
@@ -583,37 +496,105 @@
       UsersIndex.types # => [UsersIndex::User]
       UsersIndex.type_names # => ['user']
     ```
-
   * `update_elasticsearch` method name as the second argument
 
     ```ruby
       update_elasticsearch('users#user', :self)
       update_elasticsearch('users#user', :users)
     ```
-
-  * Changed index handle methods, removed `index_` prefix. I.e. was
-    `UsersIndex.index_create`, became `UsersIndex.create`
-
-  * Ability to pass value proc for source object context if arity == 0
-    `field :full_name, value: ->{ first_name + last_name }` instead of
-    `field :full_name, value: ->(u){ u.first_name + u.last_name }`
-
+  * Changed index handle methods, removed `index_` prefix. I.e. was `UsersIndex.index_create`, became `UsersIndex.create`
+  * Ability to pass value proc for source object context if arity == 0 `field :full_name, value: ->{ first_name + last_name }` instead of `field :full_name, value: ->(u){ u.first_name + u.last_name }`
   * Added `.only` chain to `update_index` matcher
-
-  * Added ability to pass ActiveRecord::Relation as a scope for load
-    `CitiesIndex.all.load(scope: {city: City.include(:country)})`
-
+  * Added ability to pass ActiveRecord::Relation as a scope for load `CitiesIndex.all.load(scope: {city: City.include(:country)})`
   * Added method `all` to index for query DSL consistency
-
   * Implemented isolated adapters to simplify adding new ORMs
+  * Query DLS chainable methods delegated to index class (no longer need to call MyIndex.search.query, just MyIndex.query)
 
-  * Query DLS chainable methods delegated to index class
-    (no longer need to call MyIndex.search.query, just MyIndex.query)
-
-# Version 0.0.1
+## 0.0.1
 
   * Query DSL
-
   * Basic index handling
-
   * Initial version
+
+[@0x0badc0de]: https://github.com/0x0badc0de
+[@aglushkov]: https://github.com/aglushkov
+[@AlexVPopov]: https://github.com/AlexVPopov
+[@AndreySavelyev]: https://github.com/AndreySavelyev
+[@arion]: https://github.com/arion
+[@arturtr]: https://github.com/arturtr
+[@averell23]: https://github.com/averell23
+[@baronworks]: https://github.com/baronworks
+[@barthez]: https://github.com/barthez
+[@bbatsov]: https://github.com/bbatsov
+[@bhacaz]: https://github.com/bhacaz
+[@biow0lf]: https://github.com/biow0lf
+[@Borzik]: https://github.com/Borzik
+[@caldwecr]: https://github.com/caldwecr
+[@clupprich]: https://github.com/clupprich
+[@dalthon]: https://github.com/dalthon
+[@davekaro]: https://github.com/davekaro
+[@dck]: https://github.com/dck
+[@dm1try]: https://github.com/dm1try
+[@dmitry]: https://github.com/dmitry
+[@dnd]: https://github.com/dnd
+[@DNNX]: https://github.com/DNNX
+[@eManPrague]: https://github.com/eManPrague
+[@eproulx-petalmd]: https://github.com/eproulx-petalmd
+[@fabiotomio]: https://github.com/fabiotomio
+[@feymartynov]: https://github.com/feymartynov
+[@gseddon]: https://github.com/gseddon
+[@guigs]: https://github.com/guigs
+[@heartfulbird]: https://github.com/heartfulbird
+[@henrebotha]: https://github.com/henrebotha
+[@inbeom]: https://github.com/inbeom
+[@jesjos]: https://github.com/jesjos
+[@JF-Lalonde]: https://github.com/JF-Lalonde
+[@jimmybaker]: https://github.com/jimmybaker
+[@jirikolarik]: https://github.com/jirikolarik
+[@jirutka]: https://github.com/jirutka
+[@joeljunstrom]: https://github.com/joeljunstrom
+[@jondavidford]: https://github.com/jondavidford
+[@joonty]: https://github.com/joonty
+[@josecoelho]: https://github.com/josecoelho
+[@josephchoe]: https://github.com/josephchoe
+[@jshirley]: https://github.com/jshirley
+[@ka8725]: https://github.com/ka8725
+[@konalegi]: https://github.com/konalegi
+[@lardawge]: https://github.com/lardawge
+[@leemhenson]: https://github.com/leemhenson
+[@Linuus]: https://github.com/Linuus
+[@lowang]: https://github.com/lowang
+[@mainameiz]: https://github.com/mainameiz
+[@MarkMurphy]: https://github.com/MarkMurphy
+[@marshall]: https://github.com/marshall
+[@matchbookmac]: https://github.com/matchbookmac
+[@matthee]: https://github.com/matthee
+[@mattzollinhofer]: https://github.com/mattzollinhofer
+[@menglewis]: https://github.com/menglewis
+[@mikeyhogarth]: https://github.com/mikeyhogarth
+[@mkcode]: https://github.com/mkcode
+[@mpeychich]: https://github.com/mpeychich
+[@mrbrdo]: https://github.com/mrbrdo
+[@mrzasa]: https://github.com/mrzasa
+[@musaffa]: https://github.com/musaffa
+[@nattfodd]: https://github.com/nattfodd
+[@okliv]: https://github.com/okliv
+[@olancheg]: https://github.com/olancheg
+[@parallel588]: https://github.com/parallel588
+[@pyromaniac]: https://github.com/pyromaniac
+[@rabotyaga]: https://github.com/rabotyaga
+[@reidab]: https://github.com/reidab
+[@robacarp]: https://github.com/robacarp
+[@robertasg]: https://github.com/robertasg
+[@rschellhorn]: https://github.com/rschellhorn
+[@sergey-kintsel]: https://github.com/sergey-kintsel
+[@sergeygaychuk]: https://github.com/sergeygaychuk
+[@SeTeM]: https://github.com/SeTeM
+[@sevab]: https://github.com/sevab
+[@sharkzp]: https://github.com/sharkzp
+[@socialchorus]: https://github.com/socialchorus
+[@taylor-au]: https://github.com/taylor-au
+[@TikiTDO]: https://github.com/TikiTDO
+[@undr]: https://github.com/undr
+[@webgago]: https://github.com/webgago
+[@yahooguntu]: https://github.com/yahooguntu