[ci skip] (docs) document include.through option for Belongs-To-Many relations.

Fixes #2975 and #3416

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).