[ 
https://issues.apache.org/jira/browse/AIRFLOW-2493?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16481952#comment-16481952
 ] 

ASF subversion and git services commented on AIRFLOW-2493:
----------------------------------------------------------

Commit dc78b9196723ca6724185231ccd6f5bbe8edcaf3 in incubator-airflow's branch 
refs/heads/master from roc
[ https://git-wip-us.apache.org/repos/asf?p=incubator-airflow.git;h=dc78b91 ]

[AIRFLOW-2493] Mark template_fields of all Operators in the API document as 
"templated"

Make all the "template_fields" (jinjia template)
of all Operators marked as "templated" in the API
document.

Closes #3386 from imroc/AIRFLOW-2493


> Mark template_fields of all Operators in the API document as "templated"
> ------------------------------------------------------------------------
>
>                 Key: AIRFLOW-2493
>                 URL: https://issues.apache.org/jira/browse/AIRFLOW-2493
>             Project: Apache Airflow
>          Issue Type: Improvement
>    Affects Versions: 2.0.0, 1.10
>            Reporter: roc chan
>            Assignee: roc chan
>            Priority: Minor
>
> I saw some words from Concepts-Additional Functionality-Jinjia Templating in 
> the document : 
> [http://airflow.readthedocs.io/en/latest/concepts.html?highlight=xcom#jinja-templating]
>  
> *You can use Jinja templating with every parameter that is marked as 
> “templated” in the documentation. Template substitution occurs just before 
> the pre_execute function of your operator is called.*
> But the actual situation of the API document is not like this,only a small 
> portion of template_fields have marked "(templated)", for example, 
> *BashOperator*'s *env* has been marked, but *bash_command* is not 
> ([http://airflow.readthedocs.io/en/latest/code.html#airflow.operators.bash_operator.BashOperator)|http://airflow.readthedocs.io/en/latest/code.html#airflow.operators.bash_operator.BashOperator)*,*],
>  which has caused some confusion. I want every template_fields of all 
> Operators in the API document has marked "(templated)"



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to