Explain joinTableAttributes versus include: { attributes } in the manuals

[papb]

Issue Description

Currently the joinTableAttributes option is barely mentioned in the manuals (ctrl+f here).

What was unclear/insufficient/not covered in the documentation

What does it do and how it relates to the more known include: { attributes: [ /* ... */ ] } option

If possible: Provide some suggestion on how we can enhance the docs

Just briefly mention it in the manuals and explain its difference, no need for complicated things...

Issue Template Checklist

Is this issue dialect-specific?

• No. This issue is relevant to Sequelize as a whole.
• Yes. This issue only applies to the following dialect(s): XXX, YYY, ZZZ
• I don't know.

Would you be willing to resolve this issue by submitting a Pull Request?

• Yes, I have the time and I know how to start.
• Yes, I have the time but I don't know how to start, I would need guidance.
• No, I don't have the time, although I believe I could do it if I had the time...
• No, I don't have the time and I wouldn't even know how to start.

[msallent]

THANK YOU!

I spent hours trying to find how to omit the through table's attributes entirely while using a mixin and this was exactly what I was looking for.

Adding to this, using joinTableAttributes is not possible while using TypeScript as the type BelongsToManyGetAssociationsMixin doesn't include it so it might be a good idea to update all the mixin types as well.

[papb]

@msallent

THANK YOU!

I spent hours trying to find how to omit the through table's attributes entirely while using a mixin and this was exactly what I was looking for.

😬

Adding to this, using joinTableAttributes is not possible while using TypeScript as the type BelongsToManyGetAssociationsMixin doesn't include it so it might be a good idea to update all the mixin types as well.

Actually this was already fixed earlier this week at sequelize/sequelize#11818, however there was no release yet.

[github-actions]

This issue has been automatically marked as stale because it has been open for 7 days without activity. It will be closed if no further activity occurs. If this is still an issue, just leave a comment or remove the "stale" label. 🙂