fatmanverse opened a new pull request, #18426:
URL: https://github.com/apache/dolphinscheduler/pull/18426
## Was this PR generated or assisted by AI?
YES. The documentation structure, usage examples, and related test additions
were assisted.
## Purpose of the pull request
Closes #18425.
The current built-in parameter guide lists variables and a subset of time
expressions, but it does not explain their behavior across different trigger
modes or how named parameters `${...}` and time expressions `$[...]` interact.
This change documents the existing behavior without changing runtime semantics.
## Brief change log
- Explain every current `system.*` built-in parameter with Shell examples
and scheduled, complement, and manual-run behavior.
- Document the benchmark time, date arithmetic, calendar boundary functions,
and `timestamp(...)`.
- Add English and Chinese parameter-combination guides with Shell, SQL,
custom parameter, and downstream parameter examples.
- Add the new guides to the documentation navigation.
- Add regression coverage for placeholder resolution order, period boundary
functions, and timestamp conversion.
## Verify this pull request
This change added tests and can be verified as follows:
- `./mvnw spotless:apply`
- `./mvnw -pl dolphinscheduler-task-plugin/dolphinscheduler-task-api -am
clean test -DskipITs -Dtest=ParameterUtilsTest,TimePlaceholderUtilsTest
-Dsurefire.failIfNoSpecifiedTests=false`
- Result: 16 tests passed with no failures or errors.
## Pull Request Notice
[Pull Request
Notice](https://github.com/apache/dolphinscheduler/blob/dev/docs/docs/en/contribute/join/pull-request.md)
--
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]
