jason810496 opened a new pull request, #73796:
URL: https://github.com/apache/airflow/pull/73796

   ## Why
   
   A Dag authored entirely in Java has no Python in the picture, but the 
native-Dag docs still taught its edge verbs as "Java's spelling of Python's 
`>>` and `<<`" and described the feature as "with no Python stub file". That 
asks the reader to know a language the feature does not involve.
   
   The mixed-language surface keeps its Python references: there the Python Dag 
file is part of what the reader has to understand.
   
   ## What
   
   `before` / `after` / `Flow.of` KDoc, the `InterfaceExample` header comment 
and the "Native Java Dags" prose now describe the behaviour directly:
   
   ```java
   loaded.before(cleaned, notified); // cleanup and notify both wait for load
   cleaned.after(loaded, transformed); // cleanup waits for load and transform
   Flow.of(a, b).before(c, d); // c and d both wait for a and b
   ```
   
   Docs and comments only, no behaviour change.
   
   ---
   
   ##### Was generative AI tooling used to co-author this PR?
   
   - [x] Yes, with help of Claude Code Opus 5 following [the 
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to