Atm we have a very big index page, where all the doc is pasted as is. We should divide the doc into sub-pages to make the pages less heavy to load.
Also, when this is done, we can decrease the size limit for triggering a warning on documentation build (revert commit e2843b365d697eaf24f385cd4072ecf5731e8127)