api-documentation icon indicating copy to clipboard operation
api-documentation copied to clipboard

Loading time / abstraction?

Open M123-dev opened this issue 4 years ago • 4 comments

For me the documentation has horrible loading times, the index.html file has 554.644 lines of computer generated code which will increase in the future with documenatation from robotoff and other features.
(The 3300 lines in off-pm-collection.js should be okay for now I think).

I would suggest that we divide the documentation a bit more. But that would probably mean that we have to move away from docgen

Any opinions on this

M123-dev avatar Sep 20 '21 15:09 M123-dev

Is that on the documentation hosted on GitHub pages ?

teolemon avatar Sep 20 '21 16:09 teolemon

I took a closer look and it seems that this only occurs with Firefox, interesting. (Mobile and PC) It gets stuck at the "TLS-handshake with static.openfoodfacts.org", and currently even longer than usual.

With Chrome, however, everything runs smoothly.

500 thousand lines are still a lot though 😄

M123-dev avatar Sep 20 '21 17:09 M123-dev

postmanerator seems more friendly than docgen, I can give it a try when I get some time to do it :)

ocervell avatar Sep 23 '21 08:09 ocervell

@M123-dev your issue is known for github pages, I think: https://stackoverflow.com/questions/48007514/github-pages-github-io-not-loading-in-firefox-and-chrome-web-browsers

ocervell avatar Sep 23 '21 08:09 ocervell