update doc

Author: chenyukang

Makefile

@@ -102,7 +102,7 @@ doc-deps: ## Build the documentation for the local package and all dependencies.
 	cargo doc --workspace
 
 .PHONY: gen-rpc-doc
-gen-rpc-doc:  submodule-init ## Generate rpc documentation
+gen-rpc-doc:
 	cd devtools/doc/rpc-gen && cargo build
 	cd docs/ckb_rpc_openrpc/ && git stash
 	./target/debug/ckb-rpc-gen rpc/README.md

devtools/doc/rpc-gen/src/main.rs

@@ -21,8 +21,15 @@ fn run_command(prog: &str, args: &[&str], dir: Option<&str>) -> Option<String> {
         })
 }
 
-fn get_tag() -> String {
-    run_command("git", &["describe", "--tags", "--abbrev=0"], None).unwrap_or("main".to_owned())
+fn get_version() -> String {
+    let version = run_command("cargo", &["pkgid"], None)
+        .unwrap()
+        .split('#')
+        .nth(1)
+        .unwrap_or("0.0.0")
+        .to_owned();
+    eprintln!("version: {:?}", version);
+    return version;
 }
 
 /// Get git tag from command line
@@ -40,13 +47,12 @@ fn checkout_tag_branch(tag: &str) {
 
 fn dump_openrpc_json() -> Result<(), Box<dyn std::error::Error>> {
     let dir = "./docs/ckb_rpc_openrpc/json/";
-    let tag = get_tag();
-    checkout_tag_branch(&tag);
-
+    let version: String = get_version();
+    checkout_tag_branch(&version);
     fs::create_dir_all(dir)?;
     let dump =
         |name: &str, doc: &mut serde_json::Value| -> Result<(), Box<dyn std::error::Error>> {
-            doc["info"]["version"] = serde_json::Value::String(tag.clone());
+            doc["info"]["version"] = serde_json::Value::String(version.clone());
             let obj = json!(doc);
             let res = serde_json::to_string_pretty(&obj)?;
             fs::write(dir.to_owned() + name, res)?;
@@ -68,7 +74,7 @@ fn dump_openrpc_json() -> Result<(), Box<dyn std::error::Error>> {
     dump("experiment_rpc_doc.json", &mut experiment_rpc_doc())?;
     eprintln!(
         "finished dump openrpc json for tag: {:?} at dir: {:?}",
-        tag, dir
+        version, dir
     );
     Ok(())
 }
@@ -89,8 +95,8 @@ pub fn gen_rpc_readme(readme_path: &str) -> Result<(), Box<dyn std::error::Error
         experiment_rpc_doc(),
     ];
 
-    let tag = get_commit_sha();
-    let generator = RpcDocGenerator::new(&all_rpc, readme_path.to_owned(), tag);
+    let commit_sha = get_commit_sha();
+    let generator = RpcDocGenerator::new(&all_rpc, readme_path.to_owned(), commit_sha);
     fs::write(readme_path, generator.gen_markdown())?;
 
     Ok(())