ENH: add timeout option #303
Description
When a docs file is stuck in execution it would be nice to be able to gracefully timeout it with an error and keep going with the other files.
Currently we experience this timeout issue with astroquery, locally the file is run 1hr+; and it would be preferable if there would be a global timeout limit and an extra bonus if that could be overwritten on the file level (e.g. some files are known to be long runners and that can be OK, but it's not if one is suddenly stuck -- like this case was with esa_hubble)
astropy/astroquery#3412 and https://github.com/astropy/astroquery/actions/runs/17687982049/job/50516902607#step:5:2763