Skip to content

Convert documentation tables and diagrams to Markdown format#105

Open
r33drichards wants to merge 2 commits intoclaude/release-post-tool-calling-Puuitfrom
claude/mermaid-diagrams-VnA2y
Open

Convert documentation tables and diagrams to Markdown format#105
r33drichards wants to merge 2 commits intoclaude/release-post-tool-calling-Puuitfrom
claude/mermaid-diagrams-VnA2y

Conversation

@r33drichards
Copy link
Copy Markdown
Owner

Summary

This PR improves documentation readability and rendering by converting ASCII tables and text-based diagrams to proper Markdown table and Mermaid diagram formats across multiple documentation files.

Key Changes

  • tutorials/token-comparison/README.md

    • Converted ASCII table of token usage metrics to Markdown table format for better readability
    • Replaced text-based architecture diagrams with Mermaid flowcharts showing the three approaches (GitHub MCP Direct, mcp-js Proxy, and gh CLI)
  • tutorials/programmatic-tool-calling.md

    • Converted text-based architecture diagram to Mermaid flowchart showing AI Agent → mcp-v8 → External MCP Servers flow
    • Converted ASCII table comparing Direct MCP vs mcp-v8 proxy token usage to Markdown table format
  • README.md

    • Converted P95 Latency table with ASCII bar chart visualization to Mermaid horizontal bar chart for clearer performance comparison across different topologies and request rates

Implementation Details

  • All conversions maintain the original data and metrics without any changes to values
  • Mermaid diagrams provide better visual representation and are natively supported by GitHub and most documentation platforms
  • Markdown tables are more maintainable and render consistently across different viewers
  • The changes improve documentation accessibility and professional appearance while preserving all technical information

https://claude.ai/code/session_01WzHDZADNci5e5DCVVVHHEF

claude added 2 commits March 3, 2026 02:08
- Convert architecture flow diagrams to Mermaid flowcharts in
  tutorials/programmatic-tool-calling.md and token-comparison/README.md
- Convert ASCII-formatted tables to proper Markdown tables
- Replace ASCII bar chart with Mermaid xychart in README.md P95 latency section

https://claude.ai/code/session_01WzHDZADNci5e5DCVVVHHEF
Replace curl-based API walkthrough with a complete agent example using
PydanticAI + Streamable HTTP MCP. Add solve_with_agent.py companion script
that solves N-Queens, Knapsack, and Graph Coloring by prompting Claude to
write JavaScript that calls MiniZinc via mcp.callTool() in the V8 sandbox.

https://claude.ai/code/session_01WzHDZADNci5e5DCVVVHHEF
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants