Yes.

As long as we will have a way to signal deprecated values usage (which I
think is possible in 2.11). One "assumption" we want to keep is that when
you move to 2.11 and remove all deprecation warnings, you should be able to
... just move.. I think this is a nice goal to have, even if it might not
always be 100% achievable - but it should be our "beacon".

We already have deprecation warnings for context - we are good with that,
so I think we are almost done, but in a few cases, I think we need a bit
more explicit explanation of what users should do when they see
the warnings. Mostly about some old dates (like next_ds).

There were a few old keys that have no "easy" replacement and so far we
explained what are the deprecated values:
https://airflow.apache.org/docs/apache-airflow/stable/templates-ref.html
but it was not really clear how to convert some of those deprecated date
values (I think even for us) - because the logic under the hood changed for
various kinds of time schedules we added in Airflow 2.

And I think we do not have to provide step-by-step clear and
straightforward answers, but more of a "this worked like this before, those
new things work like this - you need to understand that and figure out
yourself how to best adapt your DAGs".

Basically I think all deprecation warnings that we have if they cannot be
explained in a single line, should have a link to URL in our docs where we
explain more about "before" and "after" and give the user at least some
guidelines of how they should approach it.

It should IMHO not only be "easy" to migrate from 2.11 to 3.0 but also easy
to understand how to remove deprecation warnings in 2.11.

Example questions for that (but I recall there were more):

* https://github.com/apache/airflow/issues/42806
* https://github.com/apache/airflow/discussions/40113
* https://github.com/apache/airflow/issues/14572


J.




On Sun, Dec 1, 2024 at 9:07 PM Jens Scheffler <j_scheff...@gmx.de.invalid>
wrote:

> I know, it might be a bit late but still... While cleaning deprecations
> I stumbled over deprecated context entries.
>
> We have documented these entries since 2.0 and still carry them around
> many places in the code. Just wanted to briefly drop this discussion to
> feel the temperature before VOTE.
>
> Does something as argument speaks against removing the (long time)
> deprecated context variables in Airflow 3?
>
> Who does not remember: The deprecated ones are
>
> https://airflow.apache.org/docs/apache-airflow/stable/templates-ref.html#deprecated-variables
> (or search for AirflowContextDeprecationWarning)
>
> Jens
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@airflow.apache.org
> For additional commands, e-mail: dev-h...@airflow.apache.org
>
>

Reply via email to