Sequelize 7 Documentation

[ephys]

This PR is the start of a pretty thorough documentation rewrite. I'm planning on rewriting in this PR:

• the intro (minimal changes)
• getting started (minimal changes)
• how to define models (massive changes)
• how to sync (sequelize.sync, not migrations) tables
• querying (massive changes)
  • raw SQL chapter
  • JSON querying chapter
  • Operators
  • JOINS
• Associations
  • polymorphic associations

Follow-up PRs:

• Model Inheritance
• timestamp & Version decorators

Not planned in this PR:

• anything left in "other topics"
• the cli

This PR is a complete re-organization of our structure. I'm attempting to write it in the order a new user would normally follow:

1. install
2. create models
3. sync them to your DB (sync & migrations)
4. insert data & query tables
5. advanced topic: associations
6. other advanced topics

Each one is a chapter that can contain both basic and advanced topics. They're easier to find when they're grouped by a theme (e.g. defining models) rather than "basic topics and advanced topics" (like we currently have where defining models is in one place but the data types are in a completely different place)

I'm also going for TypeScript-first as much as possible

[WikiRik]

With this PR we should look into mapping old URLs to new ones (#284 (comment))

---

And this might be a good PR to fix the highlighted line in light mode;

[ephys]

The highlight is fixed in the hooks pr :)

[WikiRik]

The highlight is fixed in the hooks pr :)

Ah yes, I thought that I've seen it work properly before. There it was. Thanks!

[ephys]

Algolia provides a list of searches that had no results:

I'll try to tackle at least some of them in this PR

[ephys]

I think the following pages are ready for a first review (which would need to be done locally):

• intro
• getting started
• the models & tables chapter

The rough reading order is also set:

• first the "getting started" (I don't expect that many people will read the intro)
• then "Defining a Model" & other misc pages in "Models & Table" based on the user's need
• followed by the querying chapter
• And finally, associations

Associations & Querying are still in progress. I don't think I'll work on the following pages in this PR:

• Sequelize CLI
• Other topics

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/63ca9c6b47cbbd35fb9d7b3a
Website Draft URL: https://63ca9c6b47cbbd35fb9d7b3a--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/63caa8d36c6419471db92f1b
Website Draft URL: https://63caa8d36c6419471db92f1b--sequelize-site.netlify.app

[ephys]

Note to myself: we should document "logQueryParameters" in the section about logging

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/63fa1062771c471fb738ec85
Website Draft URL: https://63fa1062771c471fb738ec85--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/63fa3df10f930840179a6344
Website Draft URL: https://63fa3df10f930840179a6344--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/64789050db6d130088b5333e
Website Draft URL: https://64789050db6d130088b5333e--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/647896b50e71e000bea3c4af
Website Draft URL: https://647896b50e71e000bea3c4af--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/6479a7ed40ebb1035bb73363
Website Draft URL: https://6479a7ed40ebb1035bb73363--sequelize-site.netlify.app

[WikiRik]

I still need to go through the associations folder and then do a quick look through the deleted files, but this is part 2 of my review

[ephys]

@WikiRik I believe I've implemented all requested changes

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/648dd325deb93b14ad86d83a
Website Draft URL: https://648dd325deb93b14ad86d83a--sequelize-site.netlify.app

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/648f6d838dad3b669ed61aea
Website Draft URL: https://648f6d838dad3b669ed61aea--sequelize-site.netlify.app

[WikiRik]

I have not gone through the deleted files in detail yet, but that should not block the merging of this PR. These are my last few comments and then we should be good to merge

[github-actions]

Logs: https://app.netlify.com/sites/sequelize-site/deploys/64930b261649720afa35aba1
Website Draft URL: https://64930b261649720afa35aba1--sequelize-site.netlify.app

[WikiRik]

One big step closer to the first v7 beta!

[ephys]

We still have a bunch of things to document, but I'm glad this one is behind us 😮‍💨