ad-m commented on pull request #18229: URL: https://github.com/apache/superset/pull/18229#issuecomment-1025786193
I like the direction, but I am afraid about the maintenance of that solution in long term. We have a hard-coded commit ID (or git tag) and a hard-coded line number. This can be easily outdated: * the example will be updated and the commit IT will not be updated to point to the new code, * the reference will be updated with the new code, but the lines will not be changed, e.g. extended with an additional enter added. As for the first case, we may use the version identifier (git tag) instead of commit in the future. However, then the second case is then even more likely. To reduce this case scenario Apache Airflow uses comments in the referenced file ( https://github.com/apache/airflow/blob/main/docs/apache-airflow/tutorial_taskflow_api.rst ), predicable comment structure (tags eg. for examples is added before this is required in the documentation). It allows also check that references on CI. -- 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] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
