josh-fell commented on issue #22154: URL: https://github.com/apache/airflow/issues/22154#issuecomment-1401396484
The [fix for the issue @uranusjr opened](https://github.com/readthedocs/sphinx-autoapi/commit/847b6e5626dc3e85ab7e365c1893a8525a2af90a) was finally released on 2023-01-17 with [v2.0.1](https://pypi.org/project/sphinx-autoapi/2.0.1/). The proper rendering of `template_fields` should be fixed when the provider's API documentation is generated again. I can confirm that building the docs locally with `sphinx-autoapi==2.0.1` does render the `template_fields` value as expected. <img width="922" alt="image" src="https://user-images.githubusercontent.com/48934154/214215125-454916a5-63df-4e57-9bf5-9b07d2f07834.png";> Perhaps we should close this and open a new issue for some docs enhancements re: template fields based on this comments: >We should rewrite the documentation to say the attribute is only guaranteed to be a sequence, and maybe add some documentation to recommend using * instead. For your example, this is the safe syntax (without the overhead of creating a temporary list)... WDYT @uranusjr? -- 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]
![https://user-images.githubusercontent.com/48934154/214215125-454916a5-63df-4e57-9bf5-9b07d2f07834.png"](https://user-images.githubusercontent.com/48934154/214215125-454916a5-63df-4e57-9bf5-9b07d2f07834.png"){kind=link}