docs: update docs for preparation and adding reactions

README.md

@@ -15,7 +15,7 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
     $ gem install acts_as_reactable
 
-## Usage
+## Preparations
 
 ### 1. create the Reaction model
 
@@ -54,13 +54,16 @@ class User < ApplicationRecord
 end
 ```
 
-### 3. creating/updating reactions
+## Usage
+
+### adding/updating reactions
 
 ```ruby
-reaction = post.update_reaction_from(user, "😀")
+post.add_reactions(user, "😀")
+post.add_reactions(user, ["😞", "🙃"])
 ```
 
-### 4. deleting reactions
+### deleting reactions
 
 ```ruby
 post.destroy_reaction_from(user) # returns value like #destroy in ActiveRecord
@@ -69,13 +72,13 @@ post.destroy_reaction_from(user) # returns value like #destroy in ActiveRecord
 post.update_reaction_from(user)
 ```
 
-### 5. private opinion from one reactor
+### private opinion from one reactor
 
 ```ruby
 reaction = ActsAsReactable::Reaction.find_by(reactable: self, reactor: user)&.emoji
 ```
 
-### 6. group, count and sort to get a summary of public opinion
+### group, count and sort to get a summary of public opinion
 
 ```ruby
 ActsAsReactable::Reaction.where(reactable: reactor).group(:emoji).order('count_id DESC').count(:id)

spec/lib/acts_as_reactable/reactable/add_reactions_spec.rb

@@ -22,7 +22,7 @@
     it "ignores invalid emoji" do
       expect {
         post.add_reactions(user, %w[🔴 🟡 "A"])
-        # NOTE using id not being nil to check if the reaction was created
+        # NOTE using id not being nil to filter invalid reactions
         expect(post.reactions.where.not(id: nil).map(&:emoji)).to eq(%w[🔴 🟡])
       }.to change(ActsAsReactable::Reaction, :count).by(2)
     end