Merge pull request #5352 from sushantdhiman/fix-docs-3

Updated Documentation

docs/docs/associations.md

@@ -250,14 +250,27 @@ By default the code above will add projectId and userId to the UserProjects tabl
 
 
 ```js
 ```js
 UserProjects = sequelize.define('userProjects', {
 UserProjects = sequelize.define('userProjects', {
-    id: {
-      type: Sequelize.INTEGER,
-      primaryKey: true,
-      autoIncrement: true
-    },
-    status: DataTypes.STRING
+  id: {
+    type: Sequelize.INTEGER,
+    primaryKey: true,
+    autoIncrement: true
+  },
+  status: DataTypes.STRING
 })
 })
 ```
 ```
+With Belongs-To-Many you can query based on **through** relation and select specific attributes. For example using `findAll` with **through**
+
+```js
+User.findAll({
+  include: [{
+    model: Project,
+      through: {
+        attributes: ['createdAt', 'startedAt', 'finishedAt']
+          where: {completed: true}
+      }
+  }]
+});
+```
 
 
 ## Scopes
 ## Scopes
 This section concerns association scopes. For a definition of association scopes vs. scopes on associated models, see [Scopes](scopes).
 This section concerns association scopes. For a definition of association scopes vs. scopes on associated models, see [Scopes](scopes).

docs/docs/models-usage.md

@@ -556,6 +556,20 @@ To include all attributes, you can pass a single object with `all: true`:
 User.findAll({ include: [{ all: true }]});
 User.findAll({ include: [{ all: true }]});
 ```
 ```
 
 
+### Including soft deleted records
+
+In case you want to eager load soft deleted records you can do that by setting `include.paranoid` to `true`
+
+```js
+User.findAll({
+    include: [{
+        model: Tool,
+        where: { name: { $like: '%ooth%' } },
+        paranoid: true // query and loads the soft deleted records
+    }]
+});
+```
+
 ### Ordering Eager Loaded Associations
 ### Ordering Eager Loaded Associations
 
 
 In the case of a one-to-many relationship.
 In the case of a one-to-many relationship.