← Blog'a dön

Geliştirici Notları: Teknik İçeriği Kod-Öncelikli Markdown Olarak Kaydedin

· Save Team
developercodedocumentationapitemplates

Gece saat 2’de hata ayıklıyorsunuz. Stack Overflow cevabını buldunuz. Kod bloğuna, açıklamaya ve başka hiçbir şeye ihtiyacınız yok. 47 “bende de var” yorumuna değil. Kenar çubuğu reklamlarına değil. İlgili sorular karuseliine değil.

Save’in Geliştirici şablonu bir geliştiricinin gerçekten ihtiyaç duyduğu şeyler dışında her şeyi kaldırır: kod, API referansları ve teknik bağlam.

Geliştirici Okuma Sorunu

Çevrimiçi teknik içerik gürültünün altına gömülmüş:

  • Stack Overflow — oylar, yorumlar, reklamlarla çevrili cevaplar
  • Dokümantasyon — açıklama paragraflarına gömülmüş önemli kod
  • Blog öğreticileri — “Önce JavaScript’i neden sevdiğimi anlatayım…”
  • GitHub README’leri — ihtiyacınız olan tek kod örneği 400 satır aşağıda
  • API referansları — metin duvarları arasına gizlenmiş yararlı tablo

Geliştirici Şablonu Nasıl Çalışır

Save’in Geliştirici şablonu beş bölümlü kod-öncelikli format çıktısı verir:

  1. TL;DR — tek cümlede çözüm
  2. Genel Bakış — gereksizlik olmadan teknik bağlam
  3. Kod Örnekleri — her kod bloğu tam olarak korunur
  4. API Referansı — yöntemler, parametreler, dönüş türleriyle tablolar
  5. Notlar — sınır durumları, tuzaklar, sürüme özgü davranış

Tüm kod blokları sözdizimi vurgulama işaretçileriyle korunur. Teknik jargon sağlam kalır. Pazarlama dili kaldırılır.

Örnek Çıktı

Server Actions hakkında bir Next.js dokümantasyon sayfasından:

## TL;DR

Server Actions, 'use server' direktifiyle tanımlanmış, doğrudan
Client Components'ten çağrılabilen sunucuda çalışan async
fonksiyonlardır.

## Genel Bakış

Server Actions, çoğu mutasyon senaryosunda API rotalarına olan
ihtiyacı ortadan kaldırır. Next.js önbellekleme ve yeniden
doğrulama sistemleriyle entegre olurlar. Yalnızca App Router'da
kullanılabilir.

## Kod Örnekleri

### Temel Server Action

\`\`\`typescript
'use server'

export async function createPost(formData: FormData) {
  const title = formData.get('title') as string
  await db.posts.create({ data: { title } })
  revalidatePath('/posts')
}
\`\`\`

### Client Component'te Kullanım

\`\`\`typescript
'use client'

import { createPost } from './actions'

export function PostForm() {
  return (
    <form action={createPost}>
      <input name="title" />
      <button type="submit">Oluştur</button>
    </form>
  )
}
\`\`\`

## API Referansı

| Fonksiyon | Parametreler | Döndürür |
|-----------|-------------|---------|
| revalidatePath | path: string | void |
| revalidateTag | tag: string | void |
| redirect | url: string | never |
| cookies() | yok | ReadonlyRequestCookies |

## Notlar

- Server Actions async fonksiyonlar olmalıdır
- 'use server' direktifi fonksiyon veya dosya düzeyinde olabilir
- Maksimum istek gövdesi boyutu: varsayılan olarak 1MB
- Progressive enhancement ile çalışır (JS gerekmez)
- Client Component dosyalarında tanımlanamaz

Mükemmel Kullanım Durumları

Stack Overflow Cevaplarını Kaydetme

Kabul edilmiş cevabı UI karmaşası olmadan kod bloklarıyla alın. Kişisel kod referans kütüphanesi oluşturmak için mükemmel.

Dokümantasyon Anlık Görüntüleri

Değişmeden önce docs sayfalarını kaydedin. Sürümlenmiş API’ler, kullanımdan kaldırılan özellikler, geçiş kılavuzları — yerel kopyayı saklayın.

Öğretici Çıkarma

Kodlama öğreticilerini temel adımlara ve koda indirgeyerek kaydedin. Yazar arka hikayesi yok, SEO dolgusu yok.

API Referans Koleksiyonu

Geliştirici formatında referans sayfaları kaydederek kişisel API kopya kağıdı oluşturun. Tablo çıktısı anında kullanışlıdır.

Kod İnceleme Bağlamı

Tanıdık olmayan kodu incelerken ilgili dokümantasyonu kaydedin. PR yorumlarında geliştirici formatında referansları paylaşın.

Nasıl Kurulur

  1. Save’i yükleyin Chrome Web Store’dan (ücretsiz)
  2. Ayarları açın ve “Developer 💻” seçin
  3. Herhangi bir teknik sayfayı ziyaret edin — docs, Stack Overflow, öğreticiler
  4. Save’e tıklayın — anında kod-öncelikli Markdown
  5. Vault’unuzda saklayın — Obsidian, VS Code notları, GitHub wiki

Geliştiriciler Tarafından Geliştiriciler İçin

Kod bloklarını manuel olarak kopyalamayı bırakın. Dokümantasyonu yeniden biçimlendirmeyi bırakın. İhtiyacınız olan tek komutu bulmak için öğretici dolgudan geçmeyi bırakın.

Save’in Geliştirici şablonu size herhangi bir teknik sayfadan kod-öncelikli Markdown verir. Temiz, yapılandırılmış, kullanıma hazır.

Save’i Chrome Web Store’da ücretsiz deneyin