This pass tightens user-facing docs where examples were ambiguous or lacked concrete verification output. It focuses on high-traffic RST guides and adds explicit, copy-paste-friendly patterns for common workflows.

• Load/build network docs: remove ambiguity in construction paths

  • Updated docfiles/how-to/load_and_build_networks.rst to make Method 2/3 clearer and verifiable.
  • Added explicit basic_stats() checkpoints and expected output blocks so users can immediately validate shape/count assumptions.

• DSL querying docs: make multilayer semantics concrete

  • Updated docfiles/how-to/query_with_dsl.rst with a concrete layer_count example and expected output.
  • Expanded uncertainty section to show the actual result shape users should expect (dict values with mean/std/quantiles) instead of generic prose.

• Quickstart tutorial: improve first-run signal

  • Updated docfiles/getting_started/tutorial_10min.rst Example 1 to show focused output (id, degree_centrality) and an illustrative expected output block.

• Guardrail tests for doc quality regression

  • Added tests/test_docs_quality_pass.py to lock in these documentation guarantees:
    • expected-output sections exist for key creation/query tutorials,
    • multilayer layer_count explanation remains concrete,
    • uncertainty result-shape guidance remains explicit.

# Added as canonical DSL clarity pattern in docs:
layer_specific = Q.nodes().where(layer_count__eq=1).execute(network)
connectors = Q.nodes().where(layer_count__gte=2).execute(network)

print(f"Layer-specific nodes: {len(layer_specific)}")
print(f"Connector nodes: {len(connectors)}")

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.