[DOCS] Small updates to the airflow docs for clarity and put code under test

[r34ctor]

• PR title is prefixed with one of: [BUGFIX], [FEATURE], [DOCS], [MAINTENANCE], [CONTRIB]
• Code is linted - run invoke lint (uses ruff format + ruff check)
• Appropriate tests and docs have been updated

For more information about contributing, see Contribute.

After you submit your PR, keep the page open and monitor the statuses of the various checks made by our continuous integration process at the bottom of the page. Please fix any issues that come up and reach out on Slack if you need help. Thanks for contributing!

[netlify]

✅ Deploy Preview for niobium-lead-7998 canceled.

Name	Link
🔨 Latest commit	77c597f
🔍 Latest deploy log	https://app.netlify.com/sites/niobium-lead-7998/deploys/66b4e1aae8d218000854cdb9

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 78.61%. Comparing base (c5b6c7d) to head (77c597f).
Report is 91 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop   #10147      +/-   ##
===========================================
- Coverage    79.20%   78.61%   -0.59%     
===========================================
  Files          456      456              
  Lines        39703    39703              
===========================================
- Hits         31446    31214     -232     
- Misses        8257     8489     +232     

Flag	Coverage Δ
3.10	65.82% <ø> (ø)
3.10 athena or clickhouse or openpyxl or pyarrow or project or sqlite or aws_creds	?
3.10 aws_deps	?
3.10 big	?
3.10 databricks	?
3.10 filesystem	?
3.10 mssql	?
3.10 mysql	?
3.10 postgresql	?
3.10 snowflake	?
3.10 spark	?
3.10 trino	?
3.11	65.82% <ø> (ø)
3.11 athena or clickhouse or openpyxl or pyarrow or project or sqlite or aws_creds	?
3.11 aws_deps	?
3.11 big	?
3.11 databricks	?
3.11 filesystem	?
3.11 mssql	?
3.11 mysql	?
3.11 postgresql	?
3.11 snowflake	?
3.11 spark	?
3.11 trino	?
3.12	64.39% <ø> (ø)
3.12 aws_deps	45.56% <ø> (ø)
3.12 big	54.27% <ø> (ø)
3.12 filesystem	60.06% <ø> (ø)
3.12 mssql	49.66% <ø> (ø)
3.12 mysql	49.72% <ø> (ø)
3.12 postgresql	53.87% <ø> (ø)
3.12 spark	57.20% <ø> (ø)
3.12 trino	51.79% <ø> (ø)
3.8	65.88% <ø> (+0.01%)	⬆️
3.8 athena or clickhouse or openpyxl or pyarrow or project or sqlite or aws_creds	54.29% <ø> (ø)
3.8 aws_deps	45.58% <ø> (ø)
3.8 big	54.29% <ø> (ø)
3.8 databricks	46.75% <ø> (ø)
3.8 filesystem	60.08% <ø> (ø)
3.8 mssql	49.65% <ø> (ø)
3.8 mysql	49.71% <ø> (ø)
3.8 postgresql	53.86% <ø> (ø)
3.8 snowflake	47.66% <ø> (ø)
3.8 spark	57.17% <ø> (ø)
3.8 trino	51.78% <ø> (ø)
3.9	65.85% <ø> (ø)
3.9 athena or clickhouse or openpyxl or pyarrow or project or sqlite or aws_creds	?
3.9 aws_deps	?
3.9 big	?
3.9 databricks	?
3.9 filesystem	?
3.9 mssql	?
3.9 mysql	?
3.9 postgresql	?
3.9 snowflake	?
3.9 spark	?
3.9 trino	?
cloud	0.00% <ø> (ø)
docs-basic	?
docs-creds-needed	?
docs-spark	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.