cognitedata / cognite-sdk-python

Cognite Python SDK
https://cognite-sdk-python.readthedocs-hosted.com/
Apache License 2.0
77 stars 27 forks source link

Update documentation to avoid `filters as flt, aggregations as aggs` and spell them out instead #1638

Open andeplane opened 8 months ago

andeplane commented 8 months ago

Describe the bug In many of the examples in the documentation, we have imports like ... filters as flt. It looks inspired from import matplotlib.pyplot as plt, but doesn't add much value imo, and seems like it might make AI confused in code generation (also me!)

I'd like to update the documentation to import them with filters and aggregations spelled out.

haakonvt commented 8 months ago

@andeplane What about rather always importing them explicitly? I.e. change all to from ... import And, Equals