add debugging logs. move workflow for faster iterations

Author: Jiloc

.github/workflows/ci.yml

@@ -32,6 +32,15 @@ concurrency:
 run-name: ${{ github.ref_name }}
 
 jobs:
+  ## Generate and upload node configuration documentation
+  node-config-docsgen:
+    name: Node Configuration Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate Node Configuration Documentation
+        id: node_config_docsgen
+        uses: stacks-network/actions/stacks-core/node-config-docsgen@feat/node-config-docsgen
+
   ##
   ## Jobs to execute everytime workflow runs
   ##   do not run if the trigger is any of the following:
@@ -93,7 +102,7 @@ jobs:
     needs:
       - rustfmt
       - check-release
-    secrets: inherit 
+    secrets: inherit
     uses: ./.github/workflows/github-release.yml
     with:
       node_tag: ${{ needs.check-release.outputs.node_tag }}

.github/workflows/stacks-core-tests.yml

@@ -71,14 +71,14 @@ jobs:
           validate: "true"
           redocly-version: "1.34"
 
-  ## Generate and upload node configuration documentation
-  node-config-docsgen:
-    name: Node Configuration Documentation
-    runs-on: ubuntu-latest
-    steps:
-      - name: Generate Node Configuration Documentation
-        id: node_config_docsgen
-        uses: stacks-network/actions/stacks-core/node-config-docsgen@feat/node-config-docsgen
+  # ## Generate and upload node configuration documentation
+  # node-config-docsgen:
+  #   name: Node Configuration Documentation
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - name: Generate Node Configuration Documentation
+  #       id: node_config_docsgen
+  #       uses: stacks-network/actions/stacks-core/node-config-docsgen@feat/node-config-docsgen
 
   ## Disabled
   ##   - this test can take several hours to run
@@ -150,7 +150,7 @@ jobs:
     if: always()
     needs:
       - open-api-validation
-      - node-config-docsgen
+      # - node-config-docsgen
       - core-contracts-clarinet-test
     steps:
       - name: Check Tests Status

contrib/tools/config-docs-generator/generate-config-docs.sh

@@ -72,6 +72,7 @@ main() {
     # Step 2: Extract documentation from source code using rustdoc
     log_info "Extracting configuration documentation using rustdoc..."
     EXTRACTED_JSON="$TEMP_DIR/extracted-config-docs.json"
+    log_info "Extracted JSON: $EXTRACTED_JSON"
 
     # Determine the list of structs to document from section_name_mappings.json
     # If the caller sets $TARGET_STRUCTS explicitly we honour that override.

contrib/tools/config-docs-generator/src/extract_docs.rs

@@ -131,6 +131,7 @@ fn main() -> Result<()> {
     // Extract configuration documentation from the rustdoc JSON
     let config_docs = extract_config_docs_from_rustdoc(&rustdoc_json, &target_structs)?;
 
+    println!("Writing extracted docs to: {output_file}");
     // Write the extracted docs to file
     fs::write(output_file, serde_json::to_string_pretty(&config_docs)?)?;