Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CONTENT_GAPS_ANALYSIS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ This document tracks structural and quality gaps that impact completeness and di

| Metric | Value |
|:-------|:------|
| Tutorial directories | 167 |
| Tutorials with exactly 8 numbered chapters | 164 |
| Tutorial directories | 169 |
| Tutorials with exactly 8 numbered chapters | 166 |
| Tutorials with >8 numbered chapters | 3 |
| Tutorials with 0 numbered chapters | 0 |
| Tutorials with partial chapter coverage (1-7) | 0 |
Expand Down
6 changes: 4 additions & 2 deletions IMPORT_ROADMAP_TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,10 @@ This roadmap tracks the next highest-impact tutorial imports for `awesome-code-d
| [`mcp-use/mcp-use`](https://github.com/mcp-use/mcp-use) | 9k+ | P1 | `pack-bm` | done |
| [`modelcontextprotocol/modelcontextprotocol`](https://github.com/modelcontextprotocol/modelcontextprotocol) | 7k+ | P1 | `pack-bn` | done |
| [`modelcontextprotocol/go-sdk`](https://github.com/modelcontextprotocol/go-sdk) | 3k+ | P1 | `pack-bn` | done |
| [`modelcontextprotocol/java-sdk`](https://github.com/modelcontextprotocol/java-sdk) | 3k+ | P1 | `pack-bo` | in_progress |
| [`modelcontextprotocol/csharp-sdk`](https://github.com/modelcontextprotocol/csharp-sdk) | 3k+ | P1 | `pack-bo` | in_progress |
| [`modelcontextprotocol/java-sdk`](https://github.com/modelcontextprotocol/java-sdk) | 3k+ | P1 | `pack-bo` | done |
| [`modelcontextprotocol/csharp-sdk`](https://github.com/modelcontextprotocol/csharp-sdk) | 3k+ | P1 | `pack-bo` | done |
| [`modelcontextprotocol/rust-sdk`](https://github.com/modelcontextprotocol/rust-sdk) | 3k+ | P1 | `pack-bp` | in_progress |
| [`modelcontextprotocol/swift-sdk`](https://github.com/modelcontextprotocol/swift-sdk) | 1k+ | P1 | `pack-bp` | in_progress |

## P2 (Strategic Extensions)

Expand Down
24 changes: 13 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
[![GitHub stars](https://img.shields.io/github/stars/johnxie/awesome-code-docs?style=social)](https://github.com/johnxie/awesome-code-docs)
[![Tutorials](https://img.shields.io/badge/tutorials-167-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1780%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Tutorials](https://img.shields.io/badge/tutorials-169-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1820%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Last Updated](https://img.shields.io/github/last-commit/johnxie/awesome-code-docs?label=updated)](https://github.com/johnxie/awesome-code-docs/commits/main)

[**Browse Tutorials**](#-tutorial-catalog) · [**A-Z Directory**](discoverability/tutorial-directory.md) · [**Learning Paths**](#-learning-paths) · [**Contributing**](#-contributing) · [**Community**](#-community)
Expand Down Expand Up @@ -68,7 +68,7 @@ Use this quick-start map if you searched for a specific outcome.
| build RAG systems | [LlamaIndex](tutorials/llamaindex-tutorial/) | [Haystack](tutorials/haystack-tutorial/) → [RAGFlow](tutorials/ragflow-tutorial/) |
| run LLMs locally or at scale | [Ollama](tutorials/ollama-tutorial/) | [llama.cpp](tutorials/llama-cpp-tutorial/) → [vLLM](tutorials/vllm-tutorial/) → [LiteLLM](tutorials/litellm-tutorial/) |
| build AI apps with TypeScript/Next.js | [Vercel AI SDK](tutorials/vercel-ai-tutorial/) | [CopilotKit](tutorials/copilotkit-tutorial/) → [LobeChat](tutorials/lobechat-ai-platform/) |
| build MCP tools and integrations | [MCP Python SDK](tutorials/mcp-python-sdk-tutorial/) | [FastMCP](tutorials/fastmcp-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/) → [Composio](tutorials/composio-tutorial/) → [Daytona](tutorials/daytona-tutorial/) → [GenAI Toolbox](tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](tutorials/mcp-inspector-tutorial/) → [MCP Registry](tutorials/mcp-registry-tutorial/) → [MCP Specification](tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](tutorials/mcp-go-sdk-tutorial/) → [MCP Java SDK](tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) |
| build MCP tools and integrations | [MCP Python SDK](tutorials/mcp-python-sdk-tutorial/) | [FastMCP](tutorials/fastmcp-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/) → [Composio](tutorials/composio-tutorial/) → [Daytona](tutorials/daytona-tutorial/) → [GenAI Toolbox](tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](tutorials/mcp-inspector-tutorial/) → [MCP Registry](tutorials/mcp-registry-tutorial/) → [MCP Specification](tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](tutorials/mcp-swift-sdk-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) |

---

Expand Down Expand Up @@ -97,7 +97,7 @@ This section tracks high-impact open-source vibe-coding and coding-agent ecosyst
```
╔════════════════════════════════════════════════════════════╗
║ 🤖 AI & AGENTS │ 🔧 DEV TOOLS │ 🗄️ DATA │ 🎤 SPEECH ║
65+ tutorials │ 27 tutorials │ 14 tutorials │ 3 tutorials ║
67+ tutorials │ 29 tutorials │ 14 tutorials │ 3 tutorials ║
╚════════════════════════════════════════════════════════════╝
```

Expand Down Expand Up @@ -229,8 +229,10 @@ AI coding assistants, build systems, and dev infrastructure.
| **[MCP Specification](tutorials/mcp-specification-tutorial/)** | 7.1K+ | Spec/MDX | Protocol lifecycle, transports, authorization, security model, and governance workflows from the canonical MCP spec |
| **[MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/)** | 11.6K+ | TypeScript | Client/server split packages, transport strategy, and v1-to-v2 migration planning |
| **[MCP Go SDK](tutorials/mcp-go-sdk-tutorial/)** | 3.8K+ | Go | Official Go client/server SDK patterns, auth middleware, transport operations, and conformance workflows |
| **[MCP Rust SDK](tutorials/mcp-rust-sdk-tutorial/)** | 3.0K+ | Rust | Official rmcp SDK architecture, macro-driven tooling, OAuth support, and async task-oriented runtime patterns |
| **[MCP Java SDK](tutorials/mcp-java-sdk-tutorial/)** | 3.2K+ | Java | Official Java SDK module architecture, reactive transport layers, Spring integrations, and conformance loops |
| **[MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/)** | 3.9K+ | C#/.NET | Official .NET SDK package layering, ASP.NET Core transport patterns, filters, and task workflows |
| **[MCP Swift SDK](tutorials/mcp-swift-sdk-tutorial/)** | 1.2K+ | Swift | Official Swift MCP client/server setup, sampling controls, batching, and lifecycle-focused runtime operation patterns |
| **[MCP Use](tutorials/mcp-use-tutorial/)** | 9.1K+ | Python/TypeScript | Full-stack MCP agents, clients, servers, and inspector workflows across both runtimes |
| **[OpenAI Python SDK](tutorials/openai-python-sdk-tutorial/)** | 29.8K+ | Python | GPT API, embeddings, assistants, batch processing |
| **[tiktoken](tutorials/tiktoken-tutorial/)** | 17.1K+ | Python/Rust | Token counting, encoding, cost optimization |
Expand Down Expand Up @@ -359,12 +361,12 @@ Continue ──→ Aider ──→ OpenHands ──→ Claude Code ──→ Cla
> *"I want to build AI tool servers and extend Claude with custom capabilities"*

```
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ Awesome MCP Servers ──→ Composio ──→ Daytona ──→ GenAI Toolbox ──→ awslabs/mcp ──→ MCP Inspector ──→ MCP Registry ──→ MCP Specification ──→ MCP TypeScript SDK ──→ MCP Go SDK ──→ MCP Java SDK ──→ MCP C# SDK ──→ MCP Use
(build (build servers (reference (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (java sdk + (csharp sdk + (full-stack
servers) fast) implementations) curation) runtime) infra) mcp control plane) ecosystem) transport tests) discovery ops) contract deep dive) sdk internals) conformance) spring modules) aspnet filters) mcp workflows)
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ Awesome MCP Servers ──→ Composio ──→ Daytona ──→ GenAI Toolbox ──→ awslabs/mcp ──→ MCP Inspector ──→ MCP Registry ──→ MCP Specification ──→ MCP TypeScript SDK ──→ MCP Go SDK ──→ MCP Rust SDK ──→ MCP Java SDK ──→ MCP C# SDK ──→ MCP Swift SDK ──→ MCP Use
(build (build servers (reference (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (rust rmcp + (java sdk + (csharp sdk + (swift sdk + (full-stack
servers) fast) implementations) curation) runtime) infra) mcp control plane) ecosystem) transport tests) discovery ops) contract deep dive) sdk internals) conformance) task/oauth focus) spring modules) aspnet filters) lifecycle controls) mcp workflows)
```

**Duration:** 60-80 hours | **Difficulty:** Intermediate to Advanced
**Duration:** 65-90 hours | **Difficulty:** Intermediate to Advanced

### 🟢 Path 8: Speech & Voice AI

Expand Down Expand Up @@ -411,10 +413,10 @@ Dyad ──→ bolt.diy ──→ Cline ──→ Roo Code ──→ VibeSDK ─
╔══════════════════════════════════════════════════════════╗
║ COLLECTION OVERVIEW ║
╠══════════════════════════════════════════════════════════╣
║ 📦 Total Tutorials 167
║ 📝 Numbered Chapters 1,339
║ 📦 Total Tutorials 169
║ 📝 Numbered Chapters 1,355
║ 📏 Tutorial Markdown 470,000+ lines ║
║ ⏱️ Estimated Hours 1,780+ ║
║ ⏱️ Estimated Hours 1,820+ ║
║ ✅ Local Broken Links 0 ║
║ 🧭 Structure Drift 0 (all root canonical) ║
╚══════════════════════════════════════════════════════════╝
Expand Down
2 changes: 1 addition & 1 deletion TUTORIAL_STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ tutorials/<tutorial-name>/

| Pattern | Count |
|:--------|:------|
| `root_only` | 167 |
| `root_only` | 169 |
| `docs_only` | 0 |
| `index_only` | 0 |
| `mixed` | 0 |
Expand Down
6 changes: 4 additions & 2 deletions categories/ai-ml-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## Snapshot (February 12, 2026)

- repository-wide tutorials: **167**
- repository-wide tutorials: **169**
- AI/agent + developer-tooling coverage: **largest cluster in the catalog**
- canonical structure status: **all tracks publish full chapter sets**

Expand All @@ -17,7 +17,7 @@
| Build vibe-coding products | [Dyad](../tutorials/dyad-tutorial/) | [bolt.diy](../tutorials/bolt-diy-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) → [HAPI](../tutorials/hapi-tutorial/) |
| Build RAG systems | [LlamaIndex](../tutorials/llamaindex-tutorial/) | [Haystack](../tutorials/haystack-tutorial/) → [RAGFlow](../tutorials/ragflow-tutorial/) |
| Run LLMs in production | [Ollama](../tutorials/ollama-tutorial/) | [vLLM](../tutorials/vllm-tutorial/) → [LiteLLM](../tutorials/litellm-tutorial/) |
| Build MCP integrations | [MCP Python SDK](../tutorials/mcp-python-sdk-tutorial/) | [FastMCP](../tutorials/fastmcp-tutorial/) → [MCP Servers](../tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](../tutorials/awesome-mcp-servers-tutorial/) → [Composio](../tutorials/composio-tutorial/) → [Daytona](../tutorials/daytona-tutorial/) → [GenAI Toolbox](../tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](../tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](../tutorials/mcp-inspector-tutorial/) → [MCP Registry](../tutorials/mcp-registry-tutorial/) → [MCP Specification](../tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](../tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](../tutorials/mcp-go-sdk-tutorial/) → [MCP Java SDK](../tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](../tutorials/mcp-csharp-sdk-tutorial/) → [MCP Use](../tutorials/mcp-use-tutorial/) |
| Build MCP integrations | [MCP Python SDK](../tutorials/mcp-python-sdk-tutorial/) | [FastMCP](../tutorials/fastmcp-tutorial/) → [MCP Servers](../tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](../tutorials/awesome-mcp-servers-tutorial/) → [Composio](../tutorials/composio-tutorial/) → [Daytona](../tutorials/daytona-tutorial/) → [GenAI Toolbox](../tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](../tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](../tutorials/mcp-inspector-tutorial/) → [MCP Registry](../tutorials/mcp-registry-tutorial/) → [MCP Specification](../tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](../tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](../tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](../tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](../tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](../tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](../tutorials/mcp-swift-sdk-tutorial/) → [MCP Use](../tutorials/mcp-use-tutorial/) |

## Featured AI/ML Tutorial Tracks

Expand All @@ -37,8 +37,10 @@
- [MCP Specification](../tutorials/mcp-specification-tutorial/)
- [MCP TypeScript SDK](../tutorials/mcp-typescript-sdk-tutorial/)
- [MCP Go SDK](../tutorials/mcp-go-sdk-tutorial/)
- [MCP Rust SDK](../tutorials/mcp-rust-sdk-tutorial/)
- [MCP Java SDK](../tutorials/mcp-java-sdk-tutorial/)
- [MCP C# SDK](../tutorials/mcp-csharp-sdk-tutorial/)
- [MCP Swift SDK](../tutorials/mcp-swift-sdk-tutorial/)
- [MCP Use](../tutorials/mcp-use-tutorial/)
- [OpenAI Python SDK](../tutorials/openai-python-sdk-tutorial/)
- [OpenAI Realtime Agents](../tutorials/openai-realtime-agents-tutorial/)
Expand Down
6 changes: 5 additions & 1 deletion discoverability/tutorial-directory.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This page is auto-generated from the tutorial index and is intended as a fast browse surface for contributors and search crawlers.

- Total tutorials: **167**
- Total tutorials: **169**
- Source: `scripts/generate_discoverability_assets.py`

## A
Expand Down Expand Up @@ -240,10 +240,14 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.
- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md)
- Learn how `modelcontextprotocol/registry` works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.
- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/index.md)
- Learn how to use `modelcontextprotocol/rust-sdk` (`rmcp`) for production MCP clients and servers with strong transport control, macro-driven tooling, OAuth, and async task workflows.
- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/index.md)
- Learn how to use the official MCP reference servers as implementation blueprints, not drop-in production services.
- [MCP Specification Tutorial: Designing Production-Grade MCP Clients and Servers From the Source of Truth](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-specification-tutorial/index.md)
- Learn the current Model Context Protocol directly from `modelcontextprotocol/modelcontextprotocol`, including lifecycle, transports, security, authorization, and governance workflows.
- [MCP Swift SDK Tutorial: Building MCP Clients and Servers in Swift](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-swift-sdk-tutorial/index.md)
- Learn how to implement MCP client and server workflows with `modelcontextprotocol/swift-sdk`, including transport options, sampling, batching, and graceful service lifecycle control.
- [MCP TypeScript SDK Tutorial: Building and Migrating MCP Clients and Servers in TypeScript](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-typescript-sdk-tutorial/index.md)
- Learn how to use `modelcontextprotocol/typescript-sdk` to build production MCP clients and servers, migrate from v1 to v2 safely, and validate behavior with conformance workflows.
- [MCP Use Tutorial: Full-Stack MCP Development Across Agents, Clients, Servers, and Inspector](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-use-tutorial/index.md)
Expand Down
Loading