jstern commented on issue #8095: stop rendering some class docs in wrong place
URL: https://github.com/apache/airflow/pull/8095#issuecomment-609027198
 
 
   ```python
   __all__ = ['YandexCloudBaseHook']
   ```
   
   This works (needs to be a string though since it's a list of names). Thanks 
for the suggestion @ashb I agree it makes more sense than my first pass.
   
   Starting to wonder if there really isn't a bug with autoapi and it's more 
just a thing to keep in mind about how people use `__init__` modules; I think 
it's pretty normal to import names into those modules to expose them more 
conveniently, and if you're asking people to prefer importing `a.X` over 
`a.b.c.X` you probably would want your docs to reflect `a.X` ... only in this 
case the names we're importing come from a totally different place.

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


With regards,
Apache Git Services

Reply via email to