chore: Various docstring fixes

[PApostol]

SUMMARY

Various docstring fixes & improvements.

ADDITIONAL INFORMATION

• Has associated issue:
• Required feature flags:
• Changes UI
• Includes DB Migration (follow approval process in SIP-59)
  • Migration is atomic, supports rollback & is backwards-compatible
  • Confirm DB migration upgrade and downgrade tested
  • Runtime estimates and downtime expectations provided
• Introduces new feature or API
• Removes existing feature or API

[codecov]

Codecov Report

Merging #18221 (61e773e) into master (c40b337) will decrease coverage by 0.17%.
The diff coverage is n/a.

❗ Current head 61e773e differs from pull request most recent head ccb38ae. Consider uploading reports for the commit ccb38ae to get more accurate results

@@            Coverage Diff             @@
##           master   #18221      +/-   ##
==========================================
- Coverage   66.30%   66.13%   -0.18%     
==========================================
  Files        1592     1592              
  Lines       62437    62437              
  Branches     6292     6292              
==========================================
- Hits        41401    41290     -111     
- Misses      19383    19494     +111     
  Partials     1653     1653              

Flag	Coverage Δ
hive	?
mysql	81.27% <ø> (ø)
postgres	81.31% <ø> (-0.02%)	⬇️
presto	?
python	81.40% <ø> (-0.37%)	⬇️
sqlite	81.02% <ø> (ø)

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

Impacted Files	Coverage Δ
superset/utils/mock_data.py	0.00% <ø> (ø)
superset/views/utils.py	82.20% <ø> (ø)
superset/db_engines/hive.py	0.00% <0.00%> (-85.19%)	⬇️
superset/db_engine_specs/hive.py	70.27% <0.00%> (-15.45%)	⬇️
superset/db_engine_specs/presto.py	83.47% <0.00%> (-5.65%)	⬇️
superset/reports/commands/log_prune.py	85.71% <0.00%> (-3.58%)	⬇️
superset/commands/importers/v1/utils.py	89.13% <0.00%> (-2.18%)	⬇️
superset/connectors/sqla/models.py	87.06% <0.00%> (-1.45%)	⬇️
superset/common/query_object.py	95.08% <0.00%> (-0.55%)	⬇️
superset/db_engine_specs/base.py	88.05% <0.00%> (-0.38%)	⬇️
... and 3 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c40b337...ccb38ae. Read the comment docs.

[PApostol]

Hi, is anyone able to review this PR?

[PApostol]

Hi @villebro, @michael-s-molina, any chance one of you could review this PR?

[michael-s-molina]

LGTM. Thanks for the fixes!