readthedocs.org: Recent build failures for Godot Engine docs ("godot" project)

Details

Expected Result

Godot documentation should build successfully.

Actual Result

Godot has a pretty heavy documentation (GitHub repo) due to a very high number of pages (600-700 pages I think, including ~500 pages of API reference), many of those including images and hyperlinks to each other (especially in the API reference).

This seems to cause various issues, which are a bit hard to reproduce (at least each build seems to give me different errors today…):

  • We already had random build issues due to flirting too much with the set timeout of 1800 s (sphinx-build takes ages), as shown in this build log. Lately it happens a lot more.
  • Yesterday, I ran into several out of memory issues making the build abort. Strangely enough, today those error messages are no longer visible in the logs of those builds, which only report a build timeout…
  • Today, I’m getting two new issues (so far):

So I’m a bit at a loss here, any help welcome 😃 I’d gladly split the various issues mentioned above in separate tickets if relevant; as I had a hard time reproducing them I went for a bulk issue to start going further in debugging with your help.

About this issue

  • Original URL
  • State: closed
  • Created 6 years ago
  • Comments: 15 (15 by maintainers)

Most upvoted comments

@davidfischer Could I bother you again with another batch of Godot projects in need of a timeout bump to 5400?

I recently created:

godot-ko
godot-pl
godot-rus

Thanks in advance.

@davidfischer Could I ask you to increase the timeout to 5400 for the following new localization projects?

godot-de
godot-fr     (already done in the past but I since deleted and reimported it to fix GitHub hooks)
godot-pt-br
godot-uk

Thanks in advance.

I might have another batch in the future, but for now I only created projects for locales with a good level of completion: https://hosted.weblate.org/projects/godot-engine/godot-docs/