clowne 0.2.0 → 1.0.0

data/docs/implicit_cloner.md

@@ -28,7 +28,7 @@ user = User.last
 user.profile.name
 #=> "Bimbo"
 
-cloned = UserCloner.call(user)
+cloned = UserCloner.call(user).to_record
 cloned.profile.name
 # => "Clone of Bimbo"
 ```

data/docs/include_association.md

@@ -51,8 +51,8 @@ class UserCloner < Clowne::Cloner
 end
 
 # Clone only draft posts
-UserCloner.call(user, state: :draft)
-# => <#User...
+UserCloner.call(user, state: :draft).to_record
+# => <#User id: nil, ... >
 ```
 
 ## Options
@@ -93,8 +93,8 @@ class UserCloner < Clowne::Cloner
   # include_association :posts, clone_with: PostSpecialCloner, traits: :with_tags
 end
 
-UserCloner.call(user)
-# => <#User...
+UserCloner.call(user).to_record
+# => <#User id: nil, ... >
 ```
 
 **NOTE**: if custom cloner is not defined, Clowne tries to infer the [implicit cloner](implicit_cloner.md).

data/docs/init_as.md

@@ -28,9 +28,17 @@ class UserCloner < Clowne::Cloner
 end
 
 jack = User.find_by(email: 'jack@evl.ms')
+# => <#User id: 1, ...>
+jack.create_profile(name: 'Jack')
+# => <#Profile id: 1, name: 'Jack', ...>
+
 john = User.find_by(email: 'john@evl.ms')
+# => <#User id: 2, ...>
 
-# we want to clone Jack's profile settings to another user,
+# we want to clone Jack's profile to John's user,
 # without creating a new one
-UserCloner.call(jack, traits: :copy_settings, target: john)
+john_with_profile = UserCloner.call(jack, traits: :copy_settings, target: john).to_record
+# => <#User id: 2, ...>
+john_with_profile.profile
+#=> <#Profile id: nil, name: 'Jack',...>
 ```

data/docs/inline_configuration.md

@@ -6,7 +6,7 @@ title: Inline Configuration
 You can also enhance the cloner configuration inline (i.e., add declarations dynamically):
 
 ```ruby
-cloned = UserCloner.call(User.last) do
+operation = UserCloner.call(User.last) do
   exclude_association :profile
 
   finalize do |source, record|
@@ -14,6 +14,8 @@ cloned = UserCloner.call(User.last) do
   end
 end
 
+cloned = operation.to_record
+
 cloned.email
 # => "clone_of_john@example.com"
 
@@ -31,7 +33,7 @@ Thus it's also possible to clone objects without any cloner classes at all by us
 ```ruby
 cloned = Clowne::Cloner.call(user) do
   # anything you want!
-end
+end.to_record
 
 cloned
 # => <#User..

data/docs/installation.md

@@ -1,8 +1,10 @@
 ---
 id: installation
-title: Installation
+title: Installation & Configuration
 ---
 
+## Installation
+
 To install Clowne with RubyGems:
 
 ```ruby
@@ -14,3 +16,31 @@ Or add this line to your application's Gemfile:
 ```ruby
 gem 'clowne'
 ```
+
+## Configuration
+
+Basic cloner implementation looks like:
+
+```ruby
+class SomeCloner < Clowne::Cloner
+  adapter :active_record # or adapter Clowne::Adapters::ActiveRecord
+  # some implementation ...
+end
+```
+
+You can configure the default adapter for cloners:
+
+```ruby
+# put to initializer
+# e.g. config/initializers/clowne.rb
+Clowne.default_adapter = :active_record
+```
+
+and skip explicit adapter declaration
+
+```ruby
+class SomeCloner < Clowne::Cloner
+  # some implementation ...
+end
+```
+See the list of [available adapters](supported_adapters.md).

data/docs/nullify.md

@@ -21,7 +21,7 @@ class UserCloner < Clowne::Cloner
   end
 end
 
-clone = UserCloner.call(user)
+clone = UserCloner.call(user).to_record
 clone.name.nil?
 # => true
 clone.email.nil?
@@ -29,7 +29,7 @@ clone.email.nil?
 clone.surname.nil?
 # => false
 
-clone2 = UserCloner.call(user, traits: :nullify_surname)
+clone2 = UserCloner.call(user, traits: :nullify_surname).to_record
 clone2.name.nil?
 # => true
 clone2.surname.nil?

data/docs/operation.md

@@ -0,0 +1,58 @@
+---
+id: operation
+title: Operation
+---
+
+Since version 1.0 Clowne has been returning specific result object instead of a raw cloned object. It has allowed unifying interface between adapters and has opened an opportunity to implement new features. We call this object `Operation`.
+
+An instance of `Operation` has a very clear interface:
+
+```ruby
+class User < ActiveRecord::Base; end
+
+class UserCloner < Clowne::Cloner
+  nullify :email
+
+  after_persist do |_origin, cloned, **|
+    cloned.update_attributes(email: "evl-#{cloned.id}.ms")
+  end
+end
+
+user = User.create(email: 'evl.ms')
+# => <#User id: 1, email: 'evl.ms', ...>
+
+operation = UserCloner.call(user)
+
+# Return resulted (non saved) object:
+operation.to_record
+# => <#User id: nil, email: nil, ...>
+
+# Save cloned object and call after_persist callbacks:
+operation.persist # or operation.persist!
+# => true
+
+operation.to_record
+# => <#User id: 2, email: 'evl-2.ms', ...>
+
+# Call only after_persist callbacks:
+user2 = operation.to_record
+# => <#User id: 2, email: 'evl-2.ms', ...>
+user2.update_attributes(email: 'admin@example.com')
+# => <#User id: 2, email: 'admin@example.com' ...>
+operation.run_after_persist
+# => <#User id: 2, email: 'evl-2.ms', ...>
+```
+
+The last example is weird, but it can be helpful when you need to execute `save` (or `save!`) separately from `after_persist` callbacks:
+
+```ruby
+operation = UserClone.call(user)
+
+# Wrap main cloning into the transaction
+ActiveRecord::Base.transaction do
+  operation.to_record.save!
+end
+
+# And after that execute after_persist without transaction
+operation.run_after_persist
+```

data/docs/overview.md

@@ -0,0 +1,24 @@
+---
+id: overview
+title: Overview
+---
+
+In [the basic example](basic_example.md), you can see that Clowne consists of flexible DSL which is used in a class inherited of `Clowne::Cloner`.
+
+You can combinate this DSL via [`traits`](traits.md) and make a cloning plan which exactly you want.
+
+**We strongly recommend [`write tests`](testing.md) to cover resulting cloner logic**
+
+Cloner class returns [`Operation`](operation.md) instance as a result of cloning. The operation provides methods to save cloned record. You can wrap this call to a transaction if it is necessary.
+
+## Execution Order
+
+The order of cloning actions depends on the adapter (i.e., could be customized).
+
+All built-in adapters have the same order and what happens when you call `Operation#persist`:
+- init clone (see [`init_as`](init_as.md)) (empty by default)
+- [`clone associations`](include_association.md)
+- [`nullify`](nullify.md) attributes
+- run [`finalize`](finalize.md) blocks. _The order of [`finalize`](finalize.md) blocks is the order they've been written._
+- __SAVE CLONED RECORD__
+- run [`after_persist`](after_persist.md) callbacks

data/docs/parameters.md

@@ -16,7 +16,8 @@ class UserCloner < Clowne::Cloner
   end
 end
 
-cloned = UserCloner.call(user, state: :draft, email: 'cloned@example.com')
+operation = UserCloner.call(user, state: :draft, email: 'cloned@example.com')
+cloned = operation.to_record
 cloned.email
 # => 'cloned@example.com'
 ```
@@ -54,7 +55,7 @@ class UserCloner < Clowne::Cloner
   end
 
   # Pass all parameters to associations
-  trait :params_true do
+  trait :all_params do
     include_association :profile, params: true
   end
 
@@ -93,14 +94,14 @@ end
 
 def get_profile_jsonb(user, trait)
   params = { profile: { name: 'John', surname: 'Cena' } }
-  cloned = UserCloner.call(user, traits: trait, **params)
+  cloned = UserCloner.call(user, traits: trait, **params).to_record
   cloned.profile.jsonb_field
 end
 
 get_profile_jsonb(user, :default)
 # => {}
 
-get_profile_jsonb(user, :params_true)
+get_profile_jsonb(user, :all_params)
 # => { profile: { name: 'John', surname: 'Cena' } }
 
 get_profile_jsonb(user, :by_key)

data/docs/sequel.md

@@ -3,9 +3,7 @@ id: sequel
 title: Sequel
 ---
 
-Clowne uses Sequel [`NestedAttributes` plugin](http://sequel.jeremyevans.net/rdoc-plugins/classes/Sequel/Plugins/NestedAttributes.html) for cloning source's associations and you need to configure it.
-
-Also, Sequel target record wrapped into a special class for implementation full Clowne's behavior. You need to use method `to_model` for getting final cloned `Sequel::Model` object (or you can use `save` for saving the cloned object to DB).
+Under the hood, Clowne uses Sequel [`NestedAttributes` plugin](http://sequel.jeremyevans.net/rdoc-plugins/classes/Sequel/Plugins/NestedAttributes.html) for cloning source's associations, and you need to configure it.
 
 Example:
 
@@ -29,13 +27,11 @@ and get cloned user
 
 ```ruby
 user = User.last
-wrapper = UserCloner.call(user)
-wrapper.class
-# => Clowne::Adapters::Sequel::RecordWrapper
-cloned_record = wrapper.to_model
-cloned_record.class
-# => User
-cloned_record.new?
+operation = UserCloner.call(user)
+# => <#Clowne::Adapters::Sequel::Operation...>
+cloned = operation.to_record
+# => <#User id: nil, ...>
+cloned.new?
 # => true
 ```
 
@@ -43,14 +39,15 @@ or you can save it immediately
 
 ```ruby
 user = User.last
-wrapper = UserCloner.call(user)
-wrapper.class
-# => Clowne::Adapters::Sequel::RecordWrapper
-cloned_record = wrapper.save
-cloned_record.class
-# => User
-cloned_record.new?
+# => <#User id: 1, ...>
+operation = UserCloner.call(user)
+# => <#Clowne::Adapters::Sequel::Operation...>
+operation.persist
+# => true
+cloned = operation.to_record
+# => <#User id: 2, ...>
+cloned.new?
 # => false
 ```
 
-If you try to clone associations without `NestedAttributes` plugin, Clowne will skip this declaration.
+If you try to clone association without `NestedAttributes` plugin, Clowne will skip this declaration.

data/docs/supported_adapters.md

@@ -7,7 +7,7 @@ Clowne supports the following ORM adapters (and associations):
 
 Adapter                                            |1:1         | 1:M         | M:M                     |
 ---------------------------------------------------|------------|-------------|-------------------------|
-[:active_record](/clowne/docs/active_record.html)   | has_one    | has_many    | has_and_belongs_to_many |
-[:sequel](/clowne/docs/sequel.html)                 | one_to_one | one_to_many | many_to_many            |
+[:active_record](/docs/active_record.html)         | has_one    | has_many    | has_and_belongs_to_many |
+[:sequel](/docs/sequel.html)                       | one_to_one | one_to_many | many_to_many            |
 
 For more information see the corresponding adapter documentation.

data/docs/testing.md

@@ -140,7 +140,7 @@ end
 Clowne automaticaly marks all specs in `spec/cloners` folder with `type: :cloner`. Otherwise you have to add this tag you.
 
 
-## Clone actions matchers
+## Using partial cloning
 
 Under the hood, Clowne builds a [compilation plan](architecture.md) which is used to clone the record.
 
@@ -155,14 +155,14 @@ RSpec.describe UserCloner, type: :cloner do
 
   specify 'simple case' do
     # apply only the specified part of the plan
-    cloned_user = described_class.partial_apply(:nullify, user)
+    cloned_user = described_class.partial_apply(:nullify, user).to_record
     expect(cloned_user.email).to be_nil
     # finalize wasn't applied
     expect(cloned_user.name).to eq 'Bombon'
   end
 
   specify 'with params' do
-    cloned_user = described_class.partial_apply(:finalize, user, name: 'new name')
+    cloned_user = described_class.partial_apply(:finalize, user, name: 'new name').to_record
     # nullify actions were not applied!
     expect(cloned_user.email).to eq user.email
     # finalize was applied
@@ -171,7 +171,9 @@ RSpec.describe UserCloner, type: :cloner do
 
   specify 'with traits' do
     a_user = create(:user, name: 'Dindon')
-    cloned_user = described_class.partial_apply(:init_as, user, traits: :copy, target: a_user)
+    cloned_user = described_class.partial_apply(
+      :init_as, user, traits: :copy, target: a_user
+    ).to_record
     # returned user is the same as target
     expect(cloned_user).to be_eql(a_user)
     expect(cloned_user.name).to eq 'Bombon'
@@ -186,7 +188,7 @@ RSpec.describe UserCloner, type: :cloner do
     #   plan.apply(:association)
     cloned_user = described_class.partial_apply(
       'association.posts', user, traits: :with_popular_posts, min_rating: 1
-    )
+    ).to_record
 
     expect(cloned_user.posts.size).to eq 1
     expect(cloned_user.posts.first.text).to eq 'Flying Dumplings'

data/docs/web/README.md

@@ -0,0 +1,6 @@
+# Clowne Docs
+
+1. Install `node` and `yarn`
+2. `$ yarn` - install frontend deps
+3. `$ yarn run start --port 3002`
+4. `$ open http://localhost:3002`

data/docs/web/core/Footer.js

@@ -50,17 +50,13 @@ class Footer extends React.Component {
                 </a>
               </div>
           </div>
+          */}
           <div className="footer--block">
             <h5>Resources</h5>
               <div className="footer--list--item">
-                <a href="#" target="_blank">Super puper chronicles post</a>
+                <a href="https://evilmartians.com/chronicles/clowne-clone-ruby-models-with-a-smile" target="_blank">Clowne: clone Ruby models with a smile</a>
               </div>
-              <div className="footer--list--item">
-                <a href="#" target="_blank">
-                  Talk Slides
-                </a>
-              </div>
-          </div> */}
+          </div>
           <div className="footer--block legals">
             <p className="footer--copy">
               <span className="copy">{yearLabel}</span>&nbsp;
@@ -77,10 +73,10 @@ class Footer extends React.Component {
         <div className="footer--humanoids">
           <div className="humanoids">
             <div className="humanoids__martian">
-              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 108 92"><path fill="#111" d="M26 88L8 78l18-10"/><path fill="#111" d="M94 92v-6H44c-5.5 0-10-4.5-10-10s4.5-10 10-10h50V32c0-14-7.9-22-22-22H48c-14.1 0-22 8-22 22v60h68z"/><circle fill="#FFF" cx="48" cy="50" r="8"/><circle fill="#FFF" cx="72" cy="50" r="8"/><circle fill="#363636" cx="48" cy="50" r="4"/><circle fill="#363636" cx="72" cy="50" r="4"/><g fill="#fff"><path d="M48 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6zM82 50c0 5.5-4.5 10-10 10s-10-4.5-10-10 4.5-10 10-10 10 4.5 10 10zm-16 0c0 3.3 2.7 6 6 6s6-2.7 6-6-2.7-6-6-6-6 2.7-6 6z"/><path d="M102 8c-3.8 0-6-2.2-6-6 0-1.1-.9-2-2-2s-2 .9-2 2c0 2.2.5 4.1 1.5 5.7L88.2 13c-4-3.3-9.5-5-16.2-5H48c-6.7 0-12.2 1.7-16.2 4.9l-5.3-5.3C27.5 6.1 28 4.2 28 2c0-1.1-.9-2-2-2s-2 .9-2 2c0 3.8-2.2 6-6 6-1.1 0-2 .9-2 2s.9 2 2 2c2.2 0 4.1-.5 5.7-1.5l5.3 5.3c-3.2 4-4.9 9.5-4.9 16.2v34.8L3.9 78 24 89v3h4V32c0-12.9 7.1-20 20-20h24c12.9 0 20 7.1 20 20v32H44c-6.6 0-12 5.4-12 12s5.4 12 12 12h48v4h4v-8h-2l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-3.1 6.2C37.1 80.7 36 78.5 36 76c0-4.4 3.6-8 8-8l4 8 4-8h4l4 8 4-8h4l4 8 4-8h4l4 8 4-8h8V32c0-6.7-1.7-12.2-4.9-16.2l5.3-5.3c1.6 1 3.5 1.5 5.7 1.5 1.1 0 2-.9 2-2s-1-2-2.1-2zM24 84.4L12.1 78 24 71.4v13z"/></g></svg>
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 108 92"><path fill="#E2CBB5" d="M26 88L8 78l18-10"></path><path fill="#9FA628" d="M94 92v-6H44c-5.5 0-10-4.5-10-10s4.5-10 10-10h50V32c0-14-7.9-22-22-22H48c-14.1 0-22 8-22 22v60h68z"></path><circle fill="#FFF" cx="48" cy="50" r="8"></circle><circle fill="#FFF" cx="72" cy="50" r="8"></circle><circle fill="#BF6C35" cx="48" cy="50" r="4"></circle><circle fill="#BF6C35" cx="72" cy="50" r="4"></circle><g fill="#663F4C"><path d="M48 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6zM82 50c0 5.5-4.5 10-10 10s-10-4.5-10-10 4.5-10 10-10 10 4.5 10 10zm-16 0c0 3.3 2.7 6 6 6s6-2.7 6-6-2.7-6-6-6-6 2.7-6 6z"></path><path d="M102 8c-3.8 0-6-2.2-6-6 0-1.1-.9-2-2-2s-2 .9-2 2c0 2.2.5 4.1 1.5 5.7L88.2 13c-4-3.3-9.5-5-16.2-5H48c-6.7 0-12.2 1.7-16.2 4.9l-5.3-5.3C27.5 6.1 28 4.2 28 2c0-1.1-.9-2-2-2s-2 .9-2 2c0 3.8-2.2 6-6 6-1.1 0-2 .9-2 2s.9 2 2 2c2.2 0 4.1-.5 5.7-1.5l5.3 5.3c-3.2 4-4.9 9.5-4.9 16.2v34.8L3.9 78 24 89v3h4V32c0-12.9 7.1-20 20-20h24c12.9 0 20 7.1 20 20v32H44c-6.6 0-12 5.4-12 12s5.4 12 12 12h48v4h4v-8h-2l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-4 8h-4l-4-8-3.1 6.2C37.1 80.7 36 78.5 36 76c0-4.4 3.6-8 8-8l4 8 4-8h4l4 8 4-8h4l4 8 4-8h4l4 8 4-8h8V32c0-6.7-1.7-12.2-4.9-16.2l5.3-5.3c1.6 1 3.5 1.5 5.7 1.5 1.1 0 2-.9 2-2s-1-2-2.1-2zM24 84.4L12.1 78 24 71.4v13z"></path></g></svg>
             </div>
             <div className="humanoids__human">
-              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 108 92"><path fill="#FFF" d="M14 62v30h68v-6H32c-5.5 0-10-4.5-10-10s4.5-10 10-10h50v-4c4 0 8-3.6 8-8s-4-8-8-8V32c0-14-7.9-22-22-22H36c-14.1 0-22 8-22 22v14c-4 0-8 3.6-8 8s4 8 8 8z"/><circle fill="#FFF" cx="36" cy="50" r="8"/><circle fill="#FFF" cx="60" cy="50" r="8"/><circle fill="#363636" cx="36" cy="50" r="4"/><circle fill="#363636" cx="60" cy="50" r="4"/><path fill="#363636" d="M60 10H36c-14.1 0-22 8-22 22v2l4-4 6 6 6-6 6 6 6-6 6 6 6-6 6 6 6-6 6 6 6-6 4 4v-2c0-14-7.9-22-22-22z"/><g fill="#111"><path d="M36 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6zM60 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6z"/><path d="M12 63.8V92h4V32c0-12.9 7.1-20 20-20h24c12.9 0 20 7.1 20 20v32H32c-6.6 0-12 5.4-12 12s5.4 12 12 12h48v4h4v-8H74v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1c-4 0-8-3.6-8-8s3.6-8 8-8h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h4v-4.2c5-.9 8-5 8-9.8s-3-8.9-8-9.8V32c0-15.3-8.7-24-24-24H36c-15.3 0-24 8.7-24 24v12.2c-5 .9-8 5-8 9.8s3 8.9 8 9.8zm72-15.5c2 .8 4 3 4 5.7s-2 4.8-4 5.7V48.3zm-72 0v11.3c-2-.8-4-3-4-5.7s2-4.7 4-5.6z"/></g></svg>
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 108 92"><path fill="#E2CBB5" d="M14 62v30h68v-6H32c-5.5 0-10-4.5-10-10s4.5-10 10-10h50v-4c4 0 8-3.6 8-8s-4-8-8-8V32c0-14-7.9-22-22-22H36c-14.1 0-22 8-22 22v14c-4 0-8 3.6-8 8s4 8 8 8z"></path><circle fill="#FFF" cx="36" cy="50" r="8"></circle><circle fill="#FFF" cx="60" cy="50" r="8"></circle><circle fill="#9FA628" cx="36" cy="50" r="4"></circle><circle fill="#9FA628" cx="60" cy="50" r="4"></circle><path fill="#BF6C35" d="M60 10H36c-14.1 0-22 8-22 22v2l4-4 6 6 6-6 6 6 6-6 6 6 6-6 6 6 6-6 6 6 6-6 4 4v-2c0-14-7.9-22-22-22z"></path><g fill="#663F4C"><path d="M36 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6zM60 60c-5.5 0-10-4.5-10-10s4.5-10 10-10 10 4.5 10 10-4.5 10-10 10zm0-16c-3.3 0-6 2.7-6 6s2.7 6 6 6 6-2.7 6-6-2.7-6-6-6z"></path><path d="M12 63.8V92h4V32c0-12.9 7.1-20 20-20h24c12.9 0 20 7.1 20 20v32H32c-6.6 0-12 5.4-12 12s5.4 12 12 12h48v4h4v-8H74v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1h-6v-1c0-1.7-1.3-3-3-3s-3 1.3-3 3v1c-4 0-8-3.6-8-8s3.6-8 8-8h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h6v1c0 1.7 1.3 3 3 3s3-1.3 3-3v-1h4v-4.2c5-.9 8-5 8-9.8s-3-8.9-8-9.8V32c0-15.3-8.7-24-24-24H36c-15.3 0-24 8.7-24 24v12.2c-5 .9-8 5-8 9.8s3 8.9 8 9.8zm72-15.5c2 .8 4 3 4 5.7s-2 4.8-4 5.7V48.3zm-72 0v11.3c-2-.8-4-3-4-5.7s2-4.7 4-5.6z"></path></g></svg>
             </div>
           </div>
         </div>

data/docs/web/i18n/en.json

@@ -5,23 +5,26 @@
     "previous": "Previous",
     "tagline": "A flexible gem for cloning your models",
     "active_record": "Active Record",
+    "after_persist": "After Persist",
     "alternatives": "Motivation & Alternatives",
     "architecture": "Architecture",
     "basic_example": "Basic Example",
-    "configuration": "Configuration",
+    "clone_mapper": "Clone mapper",
     "customization": "Customization",
     "exclude_association": "Exclude Association",
-    "execution_order": "Execution Order",
     "finalize": "Finalization",
     "Finalize": "Finalize",
+    "from_v02_to_v10": "From v0.2.x to v1.0.0",
     "implicit_cloner": "Implicit Cloner",
     "include_association": "Include Association",
     "init_as": "Initialize Cloning Target",
     "Init As": "Init As",
     "inline_configuration": "Inline Configuration",
-    "installation": "Installation",
+    "installation": "Installation & Configuration",
     "nullify": "Nullify Attributes",
     "Nullify": "Nullify",
+    "operation": "Operation",
+    "overview": "Overview",
     "parameters": "Parameters",
     "sequel": "Sequel",
     "supported_adapters": "Supported Adapters",
@@ -126,7 +129,8 @@
     "Getting Started": "Getting Started",
     "API": "API",
     "Adapters": "Adapters",
-    "Features": "Features"
+    "Advanced Options": "Advanced Options",
+    "Upgrade Notes": "Upgrade Notes"
   },
   "pages-strings": {
     "Help Translate|recruit community translators for your project": "Help Translate",