Recover automatic documentation

[labra]

Repair the documentation generation. I would like to try: https://scalameta.org/mdoc/.

[labra]

We have almost done that. At this moment we changed the documentation generation system to use MDoc and it works very well.

There's only one pending problem which is the automatic deployment from github actions which is failing.

At this moment, if you want to deploy the documentation from your local machine, you can use:

GIT_USER=<GIT_USER> \
  CURRENT_BRANCH=master \
  USE_SSH=true \
  yarn run publish-gh-pages

But from github actions, the command is:

sbt docs/docusaurusPublishGhpages

and it fails with this message:

[info] running mdoc.Main                                                                           
info: Compiling 40 files to C:\src\utils\document\document-docs\target\mdoc                        
info: Compiled in 5,84s (0 errors)                                                                 
yarn install v1.22.4                                                                               
[1/4] Resolving packages...                                                                        
success Already up-to-date.                                                                        
Done in 0.56s.                                                                                     
Done in 0.56s.yarn run v1.22.4                                                                     
$ docusaurus-publish                                                                               
master                                                                                             
masterhttps://github.com/weso/document.git                                                         
https://github.com/weso/document.gitgenerate.js triggered...                                       
Version 9 of Highlight.js has reached EOL and is no longer supported.                              
Please upgrade or ask whatever dependency you are using to upgrade.                                
https://github.com/highlightjs/highlight.js/issues/2877                                            
sitemap.js triggered...                                                                            
sitemap.js triggered...Site built successfully. Generated files in 'build' folder.                 
Site built successfully. Generated files in 'build' folder.17860b969ab2c1a21be2a2abbe828e9777a5baa4
Cloning into 'document-gh-pages'...                                                                
Host key verification failed.                                                                      
fatal: Could not read from remote repository.                                                      
                                                                                                   
Please make sure you have the correct access rights                                                
17860b969ab2c1a21be2a2abbe828e9777a5baa4Error: git clone failed                                    
error Command failed with exit code 1.