Preview

resolves #4634

What are you changing in this pull request and why?

The main aim is to be able to easily answer each of these questions:

• which adapters support the delete+insert strategy?
• what are the names of the standard incremental strategies that are supported in at least one adapter?
• what are the names of the standard incremental strategies that are supported most frequently?
• what are the names of the standard incremental strategies that are supported least frequently?

A tabular representation with one column per strategy is the easiest way to answer all of the above.

Design decisions to be made

1. Style of the icons
2. Number of tables

Style of the icons

Any of these could work:
✅ - Green check mark
✔️ - Heavy check mark
🟢 - Green circle

We probably wouldn't choose any of these:
☑️ - Ballot box with check
🆗 - OK button
👍 - Thumbs up
etc.

Number of tables

We have several options:

1. Keep the status quo
2. Split into two tables: one for the available strategies, and another for the defaults
3. Keep a single table, keeping the "default strategy" column, but replacing the "additional supported strategies" with one column per strategy
4. Defer the default strategy information to each adapter-specific config page instead (see dbt-bigquery or dbt-redshift for examples)

Trade-offs

I strongly prefer not staying with the status quo, or I wouldn't have opened this issue 🤣

Splitting into two separate tables would solve the key problem, but at the cost of taking up more vertical space on the page.

Keeping a single table but refactoring it would work for me.

Completely moving the default strategy information into the adapter-specific pages might be the best of all worlds. It would solve the problem at hand while preserving documentation about the default strategy that is relevant for a particular adapter. dbt-postgres and dbt-redshift in particular have caveats related to the default -- it will change depending if a unique_key is defined or not.

🎩

Preview

v3 (final)

v2

v1

Note: I've since removed the 2nd table that has the defaults, but here's what it looked like with them:

Checklist

• Review the Content style guide so my content adheres to these guidelines.