mik-laj commented on pull request #13767:
URL: https://github.com/apache/airflow/pull/13767#issuecomment-766278663


   > This might be out of scope for this change, but in general, when you go to 
Operators, then click on an operator and hit "view source" the source code is 
embedded in the page. Should we instead consider redirecting folks to GitHub, 
or adding a "View on GitHub" option? (Often I want to look at the code history, 
but I recognize I'm just one data point)
   
   It is intentional for the link and example to always work. Very often these 
examples can vary drastically from one version to another, so linking to Github 
can be problematic as this changes frequently.  Besides, it can be problematic 
because of Apache releasing policy.
   
   > Projects MUST direct outsiders towards official releases rather than `raw 
source repositories`, nightly builds, snapshots, release candidates, or any 
other similar packages. 
   
   There is one more benefit to source code in the documentation. In some 
cases, we have added additional annotations to make it easier to go to a 
specific part of the documentation. See at "[docs]" link.
   
   <img width="444" alt="Screenshot 2021-01-24 at 03 24 11" 
src="https://user-images.githubusercontent.com/12058428/105619525-ab75eb00-5df3-11eb-95a0-21565b7af921.png";>
   


----------------------------------------------------------------
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.

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


Reply via email to