[GitHub] [airflow] mik-laj commented on pull request #13767: Implement provider versioning tools

[GitBox <gi...@apache.org>]

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:
users@infra.apache.org