[doc][gha] documentation generation is broken #770
Description
Describe the bug
The changes in the documentation of operators do not appear on the website anymore, and I think this is due to a broken generation of documentation files, as this phase of deployment is raising exceptions, see the logs here
We can see errors like this one:
2025-09-17T09:40:24.5596973Z Transform the docGAMA.xml file into Wiki Files (md) and create/update them in the gama.wiki folder................Beginning of the transformation
2025-09-17T09:40:28.5045493Z javax.xml.transform.TransformerException: java.io.FileNotFoundException: /home/runner/work/gama/gama/gama.documentation/files/../../../gama.wiki/gama.wiki/WikiOnly/OperatorsAA.md (No such file or directory)
2025-09-17T09:40:28.5053826Z at java.xml/com.sun.org.apache.xalan.internal.xsltc.trax.TransformerImpl.getOutputHandler(TransformerImpl.java:520)
2025-09-17T09:40:28.5055230Z at java.xml/com.sun.org.apache.xalan.internal.xsltc.trax.TransformerImpl.transform(TransformerImpl.java:379)
2025-09-17T09:40:28.5056622Z at gama.annotations.precompiler.doc.utils.XMLUtils.transformDocument(XMLUtils.java:115)
2025-09-17T09:40:28.5057587Z at gama.documentation.transform.XmlToWiki.createWiki(XmlToWiki.java:184)
2025-09-17T09:40:28.5058453Z at gama.documentation.transform.XmlToWiki.createWiki(XmlToWiki.java:145)
2025-09-17T09:40:28.5059334Z at gama.documentation.transform.XmlToWiki.createAllWikis(XmlToWiki.java:67)
2025-09-17T09:40:28.5060192Z at gama.documentation.MainGenerateWiki.main(MainGenerateWiki.java:48)
2025-09-17T09:40:28.5061662Z Caused by: java.io.FileNotFoundException: /home/runner/work/gama/gama/gama.documentation/files/../../../gama.wiki/gama.wiki/WikiOnly/OperatorsAA.md (No such file or directory)
2025-09-17T09:40:28.5062996Z at java.base/java.io.FileOutputStream.open0(Native Method)
2025-09-17T09:40:28.5063694Z at java.base/java.io.FileOutputStream.open(FileOutputStream.java:289)
2025-09-17T09:40:28.5064474Z at java.base/java.io.FileOutputStream.<init>(FileOutputStream.java:230)
2025-09-17T09:40:28.5065233Z at java.base/java.io.FileOutputStream.<init>(FileOutputStream.java:179)
2025-09-17T09:40:28.5066549Z at java.xml/com.sun.org.apache.xalan.internal.xsltc.trax.TransformerImpl.getOutputHandler(TransformerImpl.java:515)
2025-09-17T09:40:28.5067520Z ... 6 more
To Reproduce
Steps to reproduce the behavior:
- Try to find the documentation of new operators (for example I recently added
sparql_query,slice,submatrixandsublist) - See that they are nowhere to be found in the alpha version of the doc
Expected behavior
The new operators and updated comments are visible on the alpha version of the website. Also it would be nice that this action crashes in case of exception like this, because this may have been going on for months and no one had an idea