Refac generated documentation

Closes #183 (closed) and fixed the xtask gen-doc that was not compiling anymore.

cargo xtask gen-doc will now generate the rust autogenerated documentation (the full (and bloated) documentation is necessary for Substrate pallets calls). The docs/api/runtime-calls.md will be generated with reference to the rust autogenerated documentation based on the BASE_URL variable.

The only thing left to do is to decide where to store the rust autogenerated documentation. Then, a CI with the necessary server permissions can simply run:

BASE_URL="https://url/to/endpoint" cargo xtask gen-doc
rsync -a ./docs/api/doc user@server:/path/to/endpoint/

xtask/src/gen_doc.rs

@@ -21,6 +21,7 @@ use scale_info::form::PortableForm;
 use serde::Serialize;
 use std::collections::HashMap;
 use std::path::Path;
+use std::process::Command;
 use std::{
     fs::File,
     io::{Read, Write},
@@ -319,6 +320,24 @@ pub(super) fn gen_doc() -> Result<()> {
     file.write_all(error_doc.as_bytes())
         .with_context(|| format!("Failed to write to file '{}'", ERRORS_DOC_FILEPATH))?;
 
+    // Generate docs from rust code
+    Command::new("cargo")
+        .args([
+            "doc",
+            "--workspace",
+            "--no-deps",
+            "--document-private-items",
+            "--features=runtime-benchmarks",
+        ])
+        .status()
+        .expect("cargo doc failed to execute");
+
+    // Organise folder for deployment
+    Command::new("cp")
+        .args(["-r", "./target/doc", "./docs/api/"])
+        .status()
+        .expect("failed to build docs folder");
+
     Ok(())
 }