Co-authored-by: Natalie <nat@metabase.com>

* update sql parameter page

* Flamber edits

Co-authored-by: flamber <1447303+flamber@users.noreply.github.com>

* revisions

* add mongo example

Co-authored-by: flamber <1447303+flamber@users.noreply.github.com>

* Semantic types migration

* Fixup for basic querying

* Remove the relation type migration.

it makes the diff far too hard at the moment. need to be able to just
move everything from special_type -> semantic_type and then correct
the few that look at it to care about the effective type.

the PK/FK stuff gets really invasive and needs to be in its own much
smaller changeset

* Just rename special_type -> semantic_type for first change

* Special type -> semantic type

* special-type -> semantic-type

* SpecialType -> SemanticType

* special type -> semantic type

mostly in documentation, docstrings, etc

* Fix tests which relied on order of sets

database position was annotated by map-index'ing over the
set. changing `:special-type` to `:semantic-type` changed the order of
the seq produced from it.

* special -> semantic in schema_metadata

* Tim is awesome: Undo overeager special->semantic in docstrings

* Un-rename semantic_type in data_migrations

These migrations are run unless a migrations table marks them as
already having run. If they haven't run, then the db is older and the
column is special_type most likely. So we let them run as
`:special_type` and add some error handling to the migration runner
that is _opt in_.

```clojure
(defmigration ^{:author "camsaul", :added "0.20.0", :catch? true}
  migrate-field-types
  ...
  )

(try
  (@migration-var)
  (catch Exception e
    (if catch? ;; catch? from metadata
      (log/warn (format "Data migration %s failed: %s" migration-name (.getMessage e)))
      (throw e))))
```

* Fix merged master changes

just accepted their changes and fixed up rather than fix conflicts.

Co-authored-by: Console <jeffbruemmer@gmail.com>

* Added short description of sub-query functionality

Smuggled in a bunch of minor copy changes.

* Emphasize sub-query support limitation

Co-Authored-By: flamber <1447303+flamber@users.noreply.github.com>

* Escape text that looks like Jekyll variables

Co-Authored-By: flamber <1447303+flamber@users.noreply.github.com>

* s/it/them/

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Add note about sub-queries having to be in the same db

Co-Authored-By: Maz Ameli <maz@metabase.com>

Co-authored-by: flamber <1447303+flamber@users.noreply.github.com>
Co-authored-by: Maz Ameli <maz@metabase.com>

* fix mongo optional clause example [ci skip]

* run tests

* Docs minor fixes (and prettier) [ci skip]

* old FAQ move-text and Field Filter schema requirement [ci skip]

* Try to fix Server-Side Analytics table in information-collection.md [ci skip]

* Note about minimum MySQL version for application data [ci skip]

* Somehow version got changed when merging [ci skip]

* Maz suggestion: Update docs/operations-guide/configuring-application-database.md

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Maz suggestion: Update docs/operations-guide/configuring-application-database.md [ci skip]

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Maz suggestion: Update docs/users-guide/13-sql-parameters.md [ci skip]

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Maz suggestion: Update docs/users-guide/13-sql-parameters.md [ci skip]

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Maz suggestion: Update docs/users-guide/13-sql-parameters.md [ci skip]

Co-Authored-By: Maz Ameli <maz@metabase.com>

* Maz suggestion: Restore /docs/faq.md - will be a PR for another day [ci skip]

* changes to viz docs

* update sql doc images

* expand on line/area/bar settings

* add mongodo variable examples [ci skip]

* in instead of on

Co-Authored-By: Kyle Doherty <kdoh@users.noreply.github.com>

* fix typo

Co-Authored-By: Damon P. Cortesi <d.lifehacker@gmail.com>

* gerunds are a thing

Co-Authored-By: Damon P. Cortesi <d.lifehacker@gmail.com>

* add missing periods

* init

* more detail about summarizing

* start of notebook mode docs

* describe how to do joins

* Screenshot updates for Enterprise Sandboxing

* Updated screenshots for segment & metric

* Added section on new auto-run settings

* Added a note about keyboard shortcuts to run part of a query

* wrap up notebook mode docs

* update old screenshots and remove some unused ones

* update Number viz screenshot

* update a bunch of viz screenshots [ci skip]

* more viz screenshot updating [ci skip]

* misc edits to user guide [ci skip]

* update the severely outdated Getting Started guide [ci skip]

* update more screenshots and the x-rays doc [ci skip]

* update Alerts docs and screenshots [ci skip]

* update new SQL doc [ci skip]

* small edit to writing sql doc [ci skip]

* remove unused GSG images [ci skip]

* update crufty admin screenshots [ci skip]

* remove package-lock.json added by mistake [ci skip]

* resolve review feedback [ci skip]

* address kdoh's comments and prettier some pages

* Make Field Filter usage more clear, when used with Optional Clauses

* Update text - thanks Victoria!

* Add note about table alias limitation - credit Victoria

This wraps some uses of `{{}}` which was rendering ``` entities directly in the document with `{% raw %}` opening and closing tags.

It also adds a line break that was missing, causing the new paragraph to be rendered as part of the previous bullet point.