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 | 183 |
| Tutorials with exactly 8 numbered chapters | 180 |
| Tutorial directories | 185 |
| Tutorials with exactly 8 numbered chapters | 182 |
| Tutorials with >8 numbered chapters | 3 |
| Tutorials with 0 numbered chapters | 0 |
| Tutorials with partial chapter coverage (1-7) | 0 |
Expand Down
2 changes: 2 additions & 0 deletions IMPORT_ROADMAP_TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,8 @@ This roadmap tracks the next highest-impact tutorial imports for `awesome-code-d
| [`Fission-AI/OpenSpec`](https://github.com/Fission-AI/OpenSpec) | 23k+ | P1 | `pack-bv` | done |
| [`sweepai/sweep`](https://github.com/sweepai/sweep) | 7k+ | P1 | `pack-bw` | done |
| [`stagewise-io/stagewise`](https://github.com/stagewise-io/stagewise) | 6k+ | P1 | `pack-bw` | done |
| [`hangwin/mcp-chrome`](https://github.com/hangwin/mcp-chrome) | 10k+ | P1 | `pack-bx` | done |
| [`firecrawl/firecrawl-mcp-server`](https://github.com/firecrawl/firecrawl-mcp-server) | 5k+ | P1 | `pack-bx` | done |

## 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-183-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1960%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Tutorials](https://img.shields.io/badge/tutorials-185-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1980%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 @@ -69,7 +69,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/) → [MCP Quickstart Resources](tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](tutorials/create-python-server-tutorial/) → [MCP Docs Repo](tutorials/mcp-docs-repo-tutorial/) → [Create TypeScript Server](tutorials/create-typescript-server-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 Kotlin SDK](tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](tutorials/mcp-ext-apps-tutorial/) → [MCPB](tutorials/mcpb-tutorial/) → [use-mcp](tutorials/use-mcp-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/) → [MCP Quickstart Resources](tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](tutorials/create-python-server-tutorial/) → [MCP Docs Repo](tutorials/mcp-docs-repo-tutorial/) → [Create TypeScript Server](tutorials/create-typescript-server-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 Kotlin SDK](tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](tutorials/mcp-ext-apps-tutorial/) → [MCPB](tutorials/mcpb-tutorial/) → [use-mcp](tutorials/use-mcp-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) → [MCP Chrome](tutorials/mcp-chrome-tutorial/) → [Firecrawl MCP Server](tutorials/firecrawl-mcp-server-tutorial/) |

---

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

Expand Down Expand Up @@ -255,6 +255,8 @@ AI coding assistants, build systems, and dev infrastructure.
| **[MCPB](tutorials/mcpb-tutorial/)** | 1.7K+ | TypeScript/CLI | Official MCP bundle packaging format and CLI workflows for manifest authoring, packing, signing, and verification |
| **[use-mcp](tutorials/use-mcp-tutorial/)** | 1.0K+ | TypeScript/React | Archived official React hook for MCP auth, connection lifecycle, and tool/resource/prompt client integration patterns |
| **[MCP Use](tutorials/mcp-use-tutorial/)** | 9.1K+ | Python/TypeScript | Full-stack MCP agents, clients, servers, and inspector workflows across both runtimes |
| **[MCP Chrome](tutorials/mcp-chrome-tutorial/)** | 10.4K+ | TypeScript/Chrome Extension | Real-browser MCP automation with native messaging, network tooling, and semantic tab search |
| **[Firecrawl MCP Server](tutorials/firecrawl-mcp-server-tutorial/)** | 5.5K+ | TypeScript/Node | Official MCP web scraping/search server with retries, versioned endpoints, and multi-client integration paths |
| **[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 @@ -382,9 +384,9 @@ Continue ──→ Sweep ──→ OpenHands ──→ OpenCode ──→ Tabby
> *"I want to build AI tool servers and extend Claude with custom capabilities"*

```
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ MCP Quickstart Resources ──→ Create Python Server ──→ MCP Docs Repo ──→ Create TypeScript Server ──→ 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 Kotlin SDK ──→ MCP Ruby SDK ──→ MCP PHP SDK ──→ MCP Ext Apps ──→ MCPB ──→ use-mcp ──→ MCP Use
(build (build servers (reference (multi-lang (python scaffold (archived docs (typescript scaffold (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (rust rmcp + (java sdk + (csharp sdk + (swift sdk + (kmp core + (ruby server + (php server + (interactive ui + (bundle pack + (react hook + (full-stack
servers) fast) implementations) quickstart set) bootstrap path) migration map) bootstrap path) 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) transport model) client workflow) discovery model) host bridge model) sign verify) archived guidance) mcp workflows)
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ MCP Quickstart Resources ──→ Create Python Server ──→ MCP Docs Repo ──→ Create TypeScript Server ──→ 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 Kotlin SDK ──→ MCP Ruby SDK ──→ MCP PHP SDK ──→ MCP Ext Apps ──→ MCPB ──→ use-mcp ──→ MCP Use ──→ MCP Chrome ──→ Firecrawl MCP Server
(build (build servers (reference (multi-lang (python scaffold (archived docs (typescript scaffold (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (rust rmcp + (java sdk + (csharp sdk + (swift sdk + (kmp core + (ruby server + (php server + (interactive ui + (bundle pack + (react hook + (full-stack (chrome native + (web scrape +
servers) fast) implementations) quickstart set) bootstrap path) migration map) bootstrap path) 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) transport model) client workflow) discovery model) host bridge model) sign verify) archived guidance) mcp workflows) semantic tabs) search/crawl)
```

**Duration:** 100-135 hours | **Difficulty:** Intermediate to Advanced
Expand Down Expand Up @@ -434,10 +436,10 @@ Dyad ──→ bolt.diy ──→ Stagewise ──→ Cline ──→ Roo Code
╔══════════════════════════════════════════════════════════╗
║ COLLECTION OVERVIEW ║
╠══════════════════════════════════════════════════════════╣
║ 📦 Total Tutorials 183
║ 📝 Numbered Chapters 1,467
║ 📏 Tutorial Markdown 476,000+ lines ║
║ ⏱️ Estimated Hours 1,960+ ║
║ 📦 Total Tutorials 185
║ 📝 Numbered Chapters 1,483
║ 📏 Tutorial Markdown 477,000+ lines ║
║ ⏱️ Estimated Hours 1,980+ ║
║ ✅ 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` | 183 |
| `root_only` | 185 |
| `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: **183**
- repository-wide tutorials: **185**
- AI/agent + developer-tooling coverage: **largest cluster in the catalog**
- canonical structure status: **all tracks publish full chapter sets**

Expand All @@ -18,7 +18,7 @@
| Run spec-driven AI delivery workflows | [OpenSpec](../tutorials/openspec-tutorial/) | [Claude Task Master](../tutorials/claude-task-master-tutorial/) → [Codex CLI](../tutorials/codex-cli-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/) → [MCP Quickstart Resources](../tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](../tutorials/create-python-server-tutorial/) → [MCP Docs Repo](../tutorials/mcp-docs-repo-tutorial/) → [Create TypeScript Server](../tutorials/create-typescript-server-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 Kotlin SDK](../tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](../tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](../tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](../tutorials/mcp-ext-apps-tutorial/) → [MCPB](../tutorials/mcpb-tutorial/) → [use-mcp](../tutorials/use-mcp-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/) → [MCP Quickstart Resources](../tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](../tutorials/create-python-server-tutorial/) → [MCP Docs Repo](../tutorials/mcp-docs-repo-tutorial/) → [Create TypeScript Server](../tutorials/create-typescript-server-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 Kotlin SDK](../tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](../tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](../tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](../tutorials/mcp-ext-apps-tutorial/) → [MCPB](../tutorials/mcpb-tutorial/) → [use-mcp](../tutorials/use-mcp-tutorial/) → [MCP Use](../tutorials/mcp-use-tutorial/) → [MCP Chrome](../tutorials/mcp-chrome-tutorial/) → [Firecrawl MCP Server](../tutorials/firecrawl-mcp-server-tutorial/) |

## Featured AI/ML Tutorial Tracks

Expand Down Expand Up @@ -58,6 +58,8 @@
- [MCP Docs Repo](../tutorials/mcp-docs-repo-tutorial/)
- [Create TypeScript Server](../tutorials/create-typescript-server-tutorial/)
- [MCP Use](../tutorials/mcp-use-tutorial/)
- [MCP Chrome](../tutorials/mcp-chrome-tutorial/)
- [Firecrawl MCP Server](../tutorials/firecrawl-mcp-server-tutorial/)
- [OpenAI Python SDK](../tutorials/openai-python-sdk-tutorial/)
- [OpenAI Realtime Agents](../tutorials/openai-realtime-agents-tutorial/)

Expand Down
Loading