Kenapa dokumentasi itu penting

Dokumentasi ngasih konteks yang up-to-date dan akurat. Tanpanya, model bakal pakai data pelatihan yang sudah ketinggalan atau nggak lengkap. Dokumentasi bantu model ngerti hal-hal seperti:
  • API dan parameter yang berlaku saat ini
  • Praktik terbaik
  • Konvensi organisasi
  • Istilah-istilah dalam domain
Dan masih banyak lagi. Lanjut baca buat tahu cara pakai dokumentasi langsung di Cursor tanpa harus ganti konteks.

Batas pengetahuan model

Model bahasa besar dilatih pada data sampai titik waktu tertentu, yang disebut “knowledge cutoff.” Ini berarti:
  • Pembaruan library terbaru mungkin belum tercermin
  • Framework atau tool baru bisa jadi belum diketahui
  • Perubahan API setelah tanggal cutoff akan terlewat
  • Best practice mungkin sudah berkembang sejak pelatihan
Contohnya, kalau batas pengetahuan model ada di awal 2024, model nggak akan tahu fitur yang dirilis di akhir 2024, bahkan untuk framework populer.

Harus pakai tool yang mana?

Pakai pohon keputusan ini buat cepat nentuin pendekatan terbaik buat kebutuhan dokumentasi lo:

Model mental

ToolModel mental
@DocsMirip menjelajah dan membaca dokumentasi resmi
@WebMirip mencari solusi di internet
MCPMirip mengakses dokumentasi internal kamu

Dokumentasi publik

Dokumentasi eksternal mencakup informasi yang tersedia untuk umum yang mungkin pengetahuan model tentangnya terbatas atau sudah kedaluwarsa. Cursor menyediakan dua cara utama untuk mengakses informasi ini.

Menggunakan @Docs

@Docs menghubungkan Cursor ke dokumentasi resmi dari tool dan framework populer. Pakai ini saat butuh info terbaru dan tepercaya tentang:
  • Referensi API: Signature fungsi, parameter, tipe return
  • Panduan memulai: Setup, konfigurasi, penggunaan dasar
  • Praktik terbaik: Pola yang direkomendasikan dari sumber resmi
  • Debugging khusus framework: Panduan troubleshooting resmi
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
Agent⌘I
Auto

Menggunakan @Web

@Web mencari internet secara real-time untuk informasi terbaru, postingan blog, dan diskusi komunitas. Pakai ini pas lo butuh:
  • Tutorial terbaru: Konten dan contoh dari komunitas
  • Perbandingan: Artikel yang membandingkan berbagai pendekatan
  • Pembaru­an terkini: Update atau pengumuman yang sangat baru
  • Berbagai perspektif: Pendekatan berbeda untuk suatu masalah
@
@Web latest performance optimizations for React 19
Agent⌘I
Auto

Dokumentasi internal

Dokumentasi internal mencakup informasi khusus untuk organisasimu yang belum pernah ditemui model AI saat pelatihan. Ini bisa berupa:
  • API internal: Layanan kustom dan mikroservis
  • Standar perusahaan: Konvensi penulisan kode, pola arsitektur
  • Sistem proprietary: Alat kustom, basis data, alur kerja
  • Pengetahuan domain: Logika bisnis, persyaratan kepatuhan

Mengakses dokumentasi internal dengan MCP

Model Context Protocol (MCP) menyediakan cara standar buat ngebawa dokumentasi dan sistem privat lo ke Cursor. MCP bertindak sebagai lapisan tipis antara Cursor dan resource internal lo. Kenapa MCP penting:
  • Model nggak bisa nebak konvensi internal lo
  • Dokumentasi API untuk layanan kustom nggak tersedia publik
  • Business logic dan domain knowledge itu unik buat organisasi lo
  • Kebutuhan compliance dan keamanan beda-beda tiap perusahaan

Integrasi MCP yang umum

IntegrasiAksesContoh
ConfluenceSpace Confluence perusahaanDokumentasi arsitektur, spesifikasi API untuk layanan internal, standar dan pedoman coding, dokumentasi proses
Google DriveDokumen dan folder bersamaDokumen spesifikasi, catatan meeting dan keputusan, dokumen desain dan requirement, knowledge base tim
NotionDatabase dan halaman workspaceDokumentasi proyek, wiki tim, knowledge base, product requirement, spesifikasi teknis
CustomSistem dan database internalAPI proprietari, sistem dokumentasi legacy, knowledge base kustom, tool dan workflow khusus

Solusi kustom

Buat kebutuhan unik, lo bisa bikin server MCP kustom yang:
  • Nge-scrape situs atau portal internal
  • Tersambung ke database proprietari
  • Akses sistem dokumentasi kustom
  • Narik data dari wiki internal atau knowledge base
Kalau lo bikin server MCP kustom, lo juga bisa ngekspos tools biar Cursor bisa ngupdate dokumentasi
Contoh server MCP kustom buat scraping dokumen internal:
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import TurndownService from "turndown";

// Create an MCP server for scraping internal docs
const server = new McpServer({
  name: "internal-docs",
  version: "1.0.0"
});

const turndownService = new TurndownService();

// Add tool to scrape internal documentation
server.tool("get_doc",
  { url: z.string() },
  async ({ url }) => {
    try {
      const response = await fetch(url);
      const html = await response.text();
      
      // Convert HTML to markdown
      const markdown = turndownService.turndown(html);
      
      return {
        content: [{ type: "text", text: markdown }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error scraping ${url}: ${error.message}` }]
      };
    }
  }
);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);

Menjaga dokumentasi tetap mutakhir

Dokumentasi cepat ketinggalan zaman. Cursor bisa bantu lo ngerawat dokumentasi yang up-to-date dan berguna dengan ngembangin serta nge-update-nya berdasarkan kode lo yang sebenarnya dan percakapan lo selama pengembangan.

Dari kode yang sudah ada

Gunakan Cursor buat bikin dokumentasi langsung dari codebase lo:
@
Generate API documentation for this Express router, including all endpoints, parameters, and response formats
Agent⌘I
Auto

Dari sesi chat

Percakapan lo dengan Cursor punya konteks intent berharga yang bisa diubah jadi dokumentasi.
Setelah menyelesaikan masalah kompleks:
@
Ringkas percakapan kita tentang setup authentication jadi panduan langkah demi langkah buat wiki tim
Agent⌘I
Auto

Intisari

  • Dokumentasi sebagai konteks bikin Cursor lebih akurat dan mutakhir
  • Pakai @Docs buat dokumentasi resmi dan @Web buat pengetahuan komunitas
  • MCP menjembatani jarak antara Cursor dan sistem internal lo
  • Hasilkan dokumentasi dari kode dan percakapan biar pengetahuan tetap up-to-date
  • Gabungkan sumber dokumentasi eksternal dan internal buat pemahaman yang menyeluruh