SaaS Pazarlama Sayfaları ve Dokümantasyon için Web Sitesi Nasıl Kurulur
Pazarlama sayfaları ve dokümantasyonu destekleyen, net yapılı, SEO dostu, hızlı ve kolay güncellenebilir bir SaaS web sitesini nasıl planlayıp yayına alacağınızı öğrenin.

Hedefler ve Hedef Kitle: Pazarlama + Dokümantasyon Bir Arada
Pazarlama sayfaları ve dokümantasyonu birleştiren bir SaaS web sitesi iki işi yapar: yeni ziyaretçileri başlatmaya ikna etmek ve mevcut kullanıcıların başarılı olmasına yardımcı olmak. Eğer bunu “tek amaçlı bir site” olarak ele alırsanız, genellikle yalnızca bir tarafı optimize edersiniz—diğer taraf sessizce düşük performans gösterir.
Birincil hedefi tanımlayın
Pazarlama sayfaları ziyaretçiyi net bir sonraki adıma yönlendirmeli: deneme başlatma, demo talebi veya fiyatlandırmayı görme. Dokümantasyon ise kayıt sonrası sürtünmeyi azaltmalı: soruları hızlıca yanıtlamak, kurulum yol göstermek ve entegrasyon işlerini engelleyen noktaları açmak.
Planlama toplantılarında tekrarlayabileceğiniz bir cümlelik hedef yazın, örneğin:
Nitelikli potansiyel müşterileri dönüştürürken müşterilerin self-servis destek almasını sağlamak.
Sitelerin kimlere hizmet ettiğine karar verin
Çoğu SaaS sitesi farklı niyetleri olan birden çok kitleye hizmet eder:
- Potansiyel müşteriler uygunluk, kanıt ve fiyat arıyor
- Deneme kullanıcıları ilk başarı anına ulaşmaya çalışıyor
- Müşteriler güvenilir kullanım kılavuzları ve sorun giderme ihtiyaç duyuyor
- Geliştiriciler API, SDK ve uygulama detaylarını değerlendiriyor
Bir sayfanın hedef kitlesini adlandıramıyorsanız, o sayfa muğlak bir içeriğe kayar.
Temel çıktıları listeleyin (başarı nasıl görünür)
Çıktılar ekibinizi sayfa sayılarından ziyade davranışa odaklar:
- Daha fazla kayıt veya demo talebi
- Daha yüksek denemeden ücretliye dönüşüm
- Değer elde etme süresinin kısalması (kurulum tamamlandı, ilk proje oluşturuldu)
- Daha fazla self-servis yardım, daha az destek bileti
Başarı metriklerini belirleyin
Aylık kontrol edeceğiniz az sayıda metrik seçin: pazarlama dönüşüm oranı, aktivasyon oranı, doküman arama kullanımı, en sık başarısız aramalar ve konu bazlı destek bileti hacmi.
Sahipliği erkenden kesinleştirin
Pazarlama ve doküman içeriğini kim yazıyor, kim inceliyor, kim yayımlıyor bunu belirleyin. Net sahiplik eski doküman ve tutarsız ürün mesajlarının önüne geçer—ayrıca birden çok ekip güncelleme gerektiğinde lansmanları sorunsuzlaştırır.
Bilgi Mimarisi ve URL Yapısı
Bilgi mimarisi, her iki yolculuğu da açık hissettirecek şekilde düzenlemektir—başlık navigasyonunuzu bir hurda çekmecesine çevirmeden.
Küçük bir birincil bölüm setiyle başlayın
Çoğu ekip "pazarlama + doküman"ı bir avuç üst düzey alanda karşılayabilir:
- / (ana sayfa)
- /product (veya /features)
- /pricing
- /customers (vaka çalışmaları, müşteri yorumları)
- /blog
- /docs
Global navigasyonu, ilk kez gelen bir ziyaretçinin ne bekleyeceğine odaklı tutun. Diğer her şey (güvenlik, durum, changelog, partnerler, yasal) footer'da veya ilgili bölüm içinde olabilir.
Dokümantasyonun nerede duracağına karar verin: /docs mi yoksa ayrı bir alt alan mı
Çoğu SaaS ürünü için dokümanları /docs altında tutmak en basit tercihtir.
/docs altında doküman (aynı domain)
- Artıları: tek marka deneyimi, daha kolay çapraz bağlantı, tek domainin SEO avantajı, daha basit analiz
- Eksileri: tasarım ve navigasyonu koordine etmeniz gerekir, aksi halde doküman "başka bir site" gibi hissedebilir
Alt alan (örneğin docs.[your-domain])
- Artıları: araçlar, izinler veya farklı build sistemleri için daha net ayrım
- Eksileri: kopuk hissedebilir, SEO yetkisini paylaşmak zor olabilir, analiz ek yapılandırma gerektirebilir
Eğer dokümanlarınız çok kapsamlı olacaksa ve ayrı bir ekip/araç tarafından yönetilecekse alt alan makul olabilir. Aksi halde /docs genelde güvenli varsayılandır.
Menüyü kilitlemeden önce kullanıcı yolculuklarını haritalandırın
Yaygın yolları düşünün ve URL ile navigasyonun bunları desteklediğinden emin olun.
Pazarlama yolculuğu örneği:
- / → /pricing → kayıt
Destek yolculuğu örneği:
- /docs → belirli makale → ilgili sorun giderme → gerektiğinde destek ile iletişim
Navigasyon rolleri önemlidir:
- Global navigasyon pazarlama keşfini desteklemeli (Product, Pricing, Customers, Blog, Docs).
- Doküman kenar çubuğu görev tamamlama odaklı olmalı (Getting started, Guides, API, Troubleshooting).
Kararlı kalacak bir URL planı oluşturun
URL'ler birer sözleşmedir. Sonradan değiştirmek yer imlerini, gelen bağlantıları ve güveni bozar.
Pratik yaklaşım:
- Kısa, insan tarafından okunabilir slug'lar kullanın: /docs/sso, /docs/2025/07/sso-guide-final değil
- Çok dallanıp derin iç içe geçmeden kaçının; /docs/integrations/slack uygunsa sorun yok; beş seviye derinlik iyi değildir
- Bir stil seçin (kebab-case yaygındır): /docs/api-authentication
- "Versiyonlama" kararlarını kasıtlı verin (doküman versiyonlayacaksanız bunu erken belirleyin)
Yapıyı değiştirmeniz gerektiğinde, ilk günden yönlendirmeleri planlayın. Temiz bir mimari ve sabit URL'ler SaaS sitenizi daha kolay gezilir, daha kolay bakım yapılır ve büyümeye daha uygun kılar.
Dahil Edilmesi Gereken Temel Sayfa Tipleri (Önce Ne İnşa Edilmeli)
Siteniz hem satmalı hem de kullanıcıyı desteklemeli; en hızlı yol, üç soruyu cevaplayan küçük bir sayfa seti yayınlamaktır: Bu nedir? Güvenilir mi? Sonra ne yapmalıyım?
Mutlaka olması gereken pazarlama sayfaları (önce bunları yayınlayın)
Ziyaretçilerin beklediği ve ekibinizin sık başvuracağı temel sayfalarla başlayın:
- Ana sayfa: net bir değer önerisi, birincil CTA (deneme veya demo) ve kısa bir "nasıl çalışır" bölümü.
- Özellikler (veya Kullanım Durumları): sonuçları sade dille anlatın; her özelliği ilgili dokümana bağlayın.
- Fiyatlandırma: planlar, nelerin dahil olduğu, SSS ve tedarik dostu detaylar (faturalama, fatura, vergiler).
- Güvenlik (veya Güven): güvenlik özeti, veri işleme, uyumluluk iddiaları (sadece doğruysa) ve dokümantasyon talep etme yolu.
- İletişim: satış/destek iletişim seçenekleri ve basit bir form.
Her sayfayı tek bir karara odaklı tutun. Sonradan genişletebilirsiniz.
Tereddüdü azaltan güven unsurları
Kullanıcılar deneme başlatmadan önce kanıt arar. Erken aşamada hafif güven sinyalleri ekleyin:
- Müşteri logoları ve kısa referanslar (2–3 güçlü örnek yardımcı olur)
- Vaka çalışmaları varsa (bir sağlam hikaye beş belirsiz alıntıdan iyidir)
- Entegrasyonlar sayfası veya bölümü
- Eğer bir durum sayfanız varsa buna bağlantı (örnek: /status)
Dönüşüme odaklı sayfalar (gerekince ekleyin)
Temel sayfalar tamamlandığında, satış sürecinize uygun sayfalar ekleyin:
- Demo talebi (yüksek temas gerektiren satışlar için)
- Deneme başlat (kendi kendine başlayan onboarding için)
- Karşılaştırma sayfaları (sadece adil ve spesifik olabiliyorsanız)
Bu sayfalar sürtünmeyi azaltmalıdır: açık form alanları, beklentiler ("1 iş günü içinde cevap"), ve sonraki adımlar.
Dokümantasyon için gerekli temel sayfalar (ilk "aha"ı destekleyin)
Dokümanlar yeni bir kullanıcının hızlıca başarılı olmasına yardımcı olmalı:
- Getting started: kurulum/ayarlama, ilk proje ve temel kavramlar
- Guides: yaygın iş akışları ve en iyi uygulamalar
- API reference: bir API'niz varsa, eksiksiz ve aranabilir tutun
- Troubleshooting: bilinen hatalar, çözümler ve destek ile nasıl iletişime geçileceği
Siteyi tamamlayan destek sayfaları
Temel stabil olunca şunları ekleyin: changelog (/changelog), isteğe bağlı roadmap, hakkımızda ve kariyer. Bunlar şeffaflık, işe alım ve kullanıcı güveni sağlar—ilk lansmanı engellemez.
Doğru Teknoloji Yığını Seçimi (Basit Seçenekler)
Teknoloji yığını içerik değişim sıklığına, yayımlayan kişiye ve sitenin uygulama benzeri davranış gerekip gerekmediğine göre eşleşmelidir. Çoğu SaaS ekibi için ideal, hızlı hissettiren, güncellemesi kolay ve her içerik değişikliği için mühendis gerektirmeyen bir pazarlama + doküman sitesi kurmaktır.
Seçenek 1: Statik Site Üreticisi (SSG)
SSG (Next.js static export, Astro, Docusaurus, Hugo gibi) sayfaları önceden oluşturur. Pazarlama sayfaları ve dokümanlarınız öngörülebilirse bu iyi bir eşleşmedir.
Statik yaklaşımı tercih edin:
- Varsayılan olarak mükemmel hız ve SEO için
- Basit barındırma (CDN + obje depolama)
- Düşük riskli güncellemeler (içerik değişiklikleri genellikle runtime'ı bozmaz)
Ayrıca dokümanları Markdown olarak tutarken arama ve versiyonlama desteği sağlamak kolaydır.
Seçenek 2: Sunucu-taraflı site veya tam web uygulaması
Site bir ürün deneyimi gibi davranacaksa sunucu-taraflı kurulum veya tam bir uygulama gerekebilir.
Bunu seçin:
- Kişiselleştirilmiş sayfalar gerektiğinde (hesaba göre farklı içerik)
- Yetkilendirilmiş dokümanlar (dahili/özel bilgi tabanları)
- Karmaşık arama, izinler veya dinamik içerik kuralları olduğunda
Yine de pazarlama sayfalarının çoğunu statik üretebilir, yalnızca dinamik alanları sunucu tarafında render edebilirsiniz.
Seçenek 3: CMS şablonları (geleneksel veya headless)
Teknik olmayan ekipler sık sık yayın yapıyorsa ve yapılandırılmış içerik (fiyat tabloları, müşteri hikayeleri, karşılaştırma tabloları) gerekiyorsa CMS tabanlı site iyi çalışır.
İçerik depolama: Markdown/MDX vs CMS alanları
Dokümanlar için Markdown/MDX idealdir: yazması hızlı, Git içinde gözden geçirmek kolay ve versiyonlamaya uygun. Pazarlama içeriği için yapılandırılmış CMS alanları tutarlılık sağlar.
Ortamlar: local, preview, production
Başından itibaren üç ortam kurun:
- Local: hızlı iterasyon
- Preview: her branch veya PR için önizlemeler
- Production: geri alma desteği olan kilitli dağıtımlar
Bu iş akışı, pazarlama ve doküman değişiklikleri haftalık yayımlansa bile güvenli yayın sağlar.
Eğer daha erken hızlı hareket etmek isterseniz, Koder.ai gibi platformlar basit bir sohbetten başlangıç olarak pazarlama + doküman deneyimini prototiplemenize yardımcı olabilir—yapınız, navigasyon ve temel sayfalar doğrulandıktan sonra kaynak kodunu geleneksel bir pipeline'a aktarabilirsiniz.
Pazarlama Sayfaları ve Dokümanlar için Tasarım ve UX
İyi bir SaaS sitesi çift kişiliğe sahiptir: pazarlama sayfaları ikna etmeli ve bir sonraki adıma yönlendirmeli; dokümanlar ise sürtünmeyi azaltıp kullanıcıyı hızla başarıya ulaştırmalıdır. İşin püf noktası, her ikisini de tek bir ürün gibi hissettirmektir.
Hafif bir tasarım sistemiyle başlayın
Sayfaları inşa etmeden önce küçük bir tasarım sistemi tanımlayın: tipografi ölçeği, renk paleti, boşluk kuralları ve birkaç temel bileşen (butonlar, uyarılar, kartlar, sekmeler). Bu, pazarlama sayfalarınızın "tasarlanmış" ama dokümanların "varsayılan" görünmesini engeller.
Pratik yaklaşım: gövde + başlıklar için 2–3 font boyutu, bir ana marka rengi ve nötr bir arka plan/çerçeve skalası seçin. Ardından boşlukları standartlaştırın (ör. 8px adımlar) böylece düzenler landing ve doküman sayfalarında tutarlı kalır.
Yeniden kullanılabilir bölümler = daha hızlı sayfalar
Bölümler oluşturup bunları bloklar gibi birleştirin:
- Hero (değer önerisi + birincil CTA)
- Özellik ızgarası (3–6 fayda)
- SSS (destek yükünü azaltır)
- Karşılaştırma tablosu (değerlendirmeyi kolaylaştırır)
- Son CTA (deneme, demo veya fiyatlandırma)
Bu bölümler boşluk, tipografi ve buton stillerini paylaştığında, içerik büyüdükçe site tutarlı hisseder.
Dokümanları okunması kolay yapın (özellikle kod)
Doküman UX'i büyük ölçüde okunabilirlik ile ilgilidir. Net başlık hiyerarşisi, geniş satır yüksekliği ve geniş kod bloklarını destekleyecek içerik genişliği kullanın. Kod bloklarının yatay kaydırılmasına izin verin; satırların okunmaz şekilde sarılmasına izin vermeyin. Sayfaları kısa girişler, "başlamadan önce" notları ve uyarı çağrıları ile taranabilir tutun.
Erişilebilirlik ve mobil-first kontrolleri
Erişilebilirliği temel kabul edin:
- Metin ve butonlar için yeterli kontrast
- Görünür odak durumları ve tam klavye navigasyonu
- Anlamlı görseller için alt metin (dekoratifse atlayın)
Mobilde erken test edilmesi gereken iki şey: üst navigasyon menüsü ve doküman kenar çubuğu. Herhangi biri açılması, kapatılması veya anlaşılması zor ise kullanıcılar, özellikle hızlı bir çözüm arayanlar, siteyi terk eder.
Mesajlaşma, Metin ve Dönüşüm Yolları
İyi SaaS siteleri sadece ürünü "tanımlamaz"—okuyucuyu meraktan güvene götürür. Bu yol açık mesajlaşma, basit metin ve niyetli CTA'larla kurulur.
Her sayfanın işini (ve CTA'larını) tanımlayın
Yazmadan önce her sayfanın başarısının ne olduğunu belirleyin. Her ana sayfaya bir birincil CTA (istenen ana eylem) ve bir ikincil CTA (daha düşük taahhüt) verin.
Örnekler:
- Ana sayfa: Birincil Start free trial; İkincil See a demo
- Özellikler: Birincil View pricing; İkincil Read how it works
- Fiyatlandırma: Birincil Choose a plan; İkincil Talk to sales
CTA ifadelerini ve yerleşimini tutarlı tutun ki ziyaretçiler her sayfada yeniden öğrenmek zorunda kalmasın.
Fayda odaklı, spesifik metin yazın
Müşterinin önem verdiği sonuçlarla başlayın, sonra bunu nasıl sağladığınızı açıklayın. Belirsiz iddiaları ("iş akışınızı hızlandırır") somut sonuçlarla değiştirin ("onboarding süresini günlerden saatlere düşürür").
Mümkün olduğunca jargondan kaçının; kullanmak zorundaysanız açıkça tanımlayın. Kısa cümleler kazandırır—başlıklarda, alt başlıklarda ve buton metinlerinde özellikle.
Güven verici kanıt kullanın
Karar noktalarına yakın kanıt ekleyin (özellikler, fiyat, kayıt). Sayıları yalnızca doğrulayabiliyorsanız kullanın ve bağlam gösterin:
- "2.400 ekip tarafından güveniliyor" (doğruysa)
- "İşleme süresini %32 azalttı" (kısa bir açıklama ile)
Metrikleri insan kanıtlarıyla dengeleyin: alıntılar, mini vaka çalışmaları ve gerçek iş akışı örnekleri.
Fiyat şeffaflığını bir dönüşüm özelliği yapın
Kafa karıştırıcı fiyat blokları kayıtları engeller. Plan isimlerini, temel limitleri, eklentileri ve bir kullanıcı limiti aştığında ne olacağını listeleyin. Güvence için SSS ekleyin (güvenlik, faturalama, iptal, destek).
Pazarlamayı dokümantasyonla bağlayın (kullanıcıyı labirente atmayın)
Bir özelliği tanımlarken doğrudan en ilgili kılava bağlantı verin: "Nasıl çalıştığını gör" → /docs/getting-started veya /docs/integrations/slack. Bu, güven oluşturur ve satış öncesi soruları azaltır—aynı zamanda okuyucuyu ileriye taşır.
İşe Yarayan Dokümantasyon Yapısı ve Navigasyonu
İyi dokümanlar "açık" hissettirir. Sır, öngörülebilir bir yapı ve her sayfada iki soruyu yanıtlayan bir navigasyondur: Neredeyim? ve Sonraki ne okumalıyım?
Kullanıcı niyetine uygun bir kenar çubuğu ile başlayın
Doküman kenar çubuğunu az sayıda kategori ile, sade dil kullanarak oluşturun. Kategorizasyonu görevler ve sonuçlara göre yapın, iç ekip adlarına göre değil.
Yaygın üst düzey kategoriler:
- Getting Started (kurulum, ilk başarı)
- Tutorials (uçtan uca yürütmeler)
- How-to Guides ("Ekip arkadaşları davet et" gibi görevler)
- Reference (API, yapılandırma seçenekleri)
- Explanations (kavramlar, karar rehberleri, "nasıl çalışır")
Etiketleri ürününüzün arayüzünde kullandığınız terimlerle tutarlı tutun. Eğer arayüzünüzde "Workspaces" deniyorsa, dokümanda onları "Projects" diye adlandırmayın.
Kaydırmayı azaltan sayfa içi navigasyon ekleyin
Uzun sayfalarda, okuyucuların doğru bölüme atlaması için başta bir içerik tablosu ekleyin. Sayfanın sonunda Next/Previous bağlantıları ekleyin; bu, özellikle kurulum ve onboarding dizilerinde akıcı bir okuma yolu sağlar.
Her kılavuzun tanıdık olmasını sağlayacak şablonlar kullanın
Tutarlılık bir özelliktir. Her yeni makalenin familiar olmasını sağlayacak tek bir şablon kullanın:
Problem → Adımlar → Beklenen sonuç → Sorun giderme
Bu desen okuyucuların hızlı taramasına yardımcı olur ve ekibinizin yeni makaleler yazmasını kolaylaştırır.
Dokümanları sürekli iyileştirmeyi kolaylaştırın
Her sayfaya hafif geri bildirim seçenekleri ekleyin: "Bu yardımcı oldu mu?" kontrolü ve destekle iletişim için net bir bağlantı (örnek: /contact veya /support). Geri bildirimler gerçek sorularla dokümanları hizalar ve sinirlenen okuyucuların yardım aramasını kolaylaştırır.
İçerik İş Akışı: Bozmadan Güncelleme Yapmak
SaaS sitesi sürekli değişir: fiyat ayarlamaları, yeni özellikler, doküman düzeltmeleri ve duyurular. Amaç, insanlara kolay güncelleme sağlarken siteyi gezilebilir, araması çalışır ve SEO'ya zarar gelmez halde tutmaktır.
Basit bir içerik modeli belirleyin
Her sayfa türünü yapılandırılmış içerik olarak ele alın. Markdown/MDX kullanıyorsanız, front matter'ı tutarlı tanımlayın ki sayfalar listelenebilsin, aranabilsin ve doğru görüntülensin.
Yaygın alanlar:
title(sayfa başlığında gösterilecek)description(meta + kartlar)tagsveyacategory(gruplama ve filtreleme)last_updated(doküman için güven sinyali)sidebar_position(doküman sıralaması)
Tutarlılık "gizemli sayfalar"ın menüde görünmemesi veya listelerde yanlış görünmesini engeller.
Herkesin takip edebileceği bir editoryal iş akışı kullanın
Hafif bir pipeline hataları azaltır:
Taslak → İnceleme → Yayımla
Taslaklar bir branch'te (Git) veya headless CMS'de oluşturulabilir. İncelemeler açıklık, doğruluk ve bağlantı/CTA doğruluğunu kontrol etmelidir (ör. /pricing veya /docs).
Ekran görüntüleri yerine önizleme linkleriyle inceleyin
Yapılan değişiklikleri yapıştırılmış metin veya ekran görüntülerinden onaylamayın. İnceleyenlerin sayfayı bağlam içinde görmesi için önizleme linkleri kullanın (navigasyon, mobil düzen, çapraz bağlantılar dahil).
Tipik seçenekler:
- Pull request önizlemeleri (PR başına otomatik deploy)
- Production'ı yansıtan bir staging ortamı
Tutarlılık sağlayan stil rehberi
Kararlarınızı bir kez yazın: ses tonu, başlık yapısı, kod/örnek kullanım kuralları ve ekran görüntülerinin nasıl alınacağı/güncelleneceği. Bu, birden çok kişinin katkıda bulunduğu dokümanların bile uyumlu görünmesini sağlar.
Net sahiplik (ve tırmanma)
Kimin neyi yönettiğini belirleyin:
- Pazarlama pazarlama sayfalarını yönetir
- Ürün/destek dokümanları yönetir
Ayrıca paylaşılan sayfalar için bir karar merci seçin (ana sayfa, navigasyon etiketleri) ki değişiklikler tıkanmasın.
Pazarlama + Dokümantasyon İçeren SaaS Siteleri için SEO
Pazarlama sayfaları ve dokümanlar aynı sitede olduğunda SEO kolaylaşır: yetki inşa edilebilir, iç bağlantılar paylaşılabilir ve sinyaller alt alanlara bölünmez.
Sayfa içi temel kurallar
Her indekslenebilir sayfada temel kuralları uygulayın:
- Benzersiz başlıklar ve meta açıklamalar (özellik sayfaları satmalı; dokümanlar açıklamalı)
- Tek bir net H1, ardından insanların tarama alışkanlıklarına göre H2/H3 başlıkları
- Açıklayıcı iç bağlantılar ("buraya tıkla"dan kaçının). Örneğin bir özellik sayfasından kurulum dokümanına /docs/getting-started şeklinde bağlanın ve geri dönüş olarak /pricing gibi dönüşüm sayfalarına link verin.
URL ve linklerde basit bir kural oluşturun: her zaman relatif yollar kullanın (ör. /pricing, /docs/api/auth). Bu staging/production ortamlarını tutarlı kılar ve kırık bağlantıları azaltır.
Pazarlama ile doküman arasında tekrar eden içeriği önleyin
Birleştirilmiş sitelerde en büyük risk aynı açıklamayı birden çok yerde tekrar etmektir (örneğin özellik sayfasında ve dokümanda "SSO nasıl çalışır" açıklaması).
Çakışma kaçınılmazsa:
- Bir sayfayı "gerçek kaynak" yapın ve diğerinden ona link verin.
- İki sayfa olması gerekiyorsa, tercih edilen versiyonu arama motorlarına göstermek için canonical etiketleri kullanın.
Yapısal veri (schema) kullanımı
Schema'yı sadece doğruysa ekleyin:
- Önemli ürün sayfalarında SoftwareApplication
- Gerçek SSS bölümlerinde FAQPage (pazarlama süslü SSS değilse)
- Blog gönderileri ve uzun rehberlerde Article
Konu kümeleri (topic clusters) oluşturun
Blog gönderileri geniş soruları cevaplasın ve okuyucuyu bir sonraki adıma yönlendirsin:
- Blog: “SSO nasıl kurulur” → /features/sso ve /docs/sso/setup
- Blog: “Webhook güvenlik kontrol listesi” → /docs/webhooks/security ve /features/webhooks
Bu yapı hem sıralama hem de dönüşüm açısından yardımcı olur—dokümanları satış konuşması gibi yazmaya zorlamadan.
Performans, Güvenlik ve Gizlilik Temelleri
Pazarlama sayfaları ve dokümanları karışık bir SaaS sitesi hızlı ve güvenilir hissetmelidir. Küçük gerilemeler (ağır bir script, yeni bir font, büyük bir ekran görüntüsü) hızlıca birikir.
Önemli performans hedefleri
Her sürümde kontrol edeceğiniz birkaç ölçü belirleyin:
- Hızlı yükleme: orta sınıf bir mobil cihazda LCP ~2–2.5s hedefleyin.
- Düzen stabilitesi: görseller, embed'ler ve bannerlar için yer ayırarak CLS düşük tutun.
- Akıcı etkileşim: uzun ana-iş parçaları (main-thread) yaratan kodlardan kaçının—doküman sayfalarında kod vurgu ve arama widget'ları render'ı engelleyebilir.
Pratik optimizasyonlar (yüksek etki, düşük drama)
Kullanıcıların önce indirdiği şeyleri optimize edin:
- Görseller: modern formatlar (WebP/AVIF), responsive boyutlar ve fold altı görseller için lazy-load—dokümanlar çok fazla ekran görüntüsü içeriyorsa özellikle önemli.
- Fontlar: font ailelerini/ağırlıklarını sınırlayın,
font-display: swapkullanın ve üçüncü taraf istekleri azaltmak için self-host etmeyi düşünün. - Scriptler: kritik olmayan scriptleri (analitik, sohbet, A/B testleri) erteleyin. Her yeni tag'i bir performans bütçesi isteği gibi değerlendirin.
Ayrıca önbellekleme ve dağıtım konusuna dikkat edin: statik varlıkları uzun cache header'ları ile sunun ve hostinginiz CDN sunmuyorsa bir CDN kullanın.
Atlanmaması gereken güvenlik temelleri
- Her yerde HTTPS ve HTTP → HTTPS yönlendirmesi.
- Yaygın güvenlik başlıklarını ekleyin (HSTS, X-Content-Type-Options, Referrer-Policy; yönetebiliyorsanız CSP).
- Bağımlılıkları güncel tutun, özellikle doküman araçları, arama ve build pipeline'ları için.
- Özel build log'larını veya önizleme URL'lerini açığa çıkarmayın; staging'i yetkiyle koruyun.
Gizlilik: takipçileri en aza indirin
Sadece gerekli olan verileri toplayın. Daha az araçla sorulara cevap verebiliyorsanız onu tercih edin.
- Çerez banner'ını sadece gerekliyse kullanın (yargı + takip davranışına göre).
- Gizliliğe uygun analitik tercih edin ve dokümanlarda marketing pixel'leri yüklemekten kaçının, aksi halde net bir neden olmalı.
Erişilebilirlik ve güven sinyalleri
Hafif izleme ekleyin ve bir durum sayfanız varsa ona bağlantı verin (örnek: /status). Yoksa bile bir olay güncelleme yolu sağlayın (footer'da destek sayfasına bağlantı) ki kullanıcılar bir şeyler bozulduğunda nereden kontrol edeceklerini bilsinler.
Arama, Analitik ve Sürekli İyileştirme
Pazarlama sayfaları ve doküman içeren bir SaaS sitesi asla "bitmiş" değildir. En hızlı iyileşme yolu insanların gerçekten nasıl kullandığını izlemektir: ne aradıkları, nerede takıldıkları ve hangi sayfaların kayıt getirdiği.
Site araması ekleyin (basit başlayın)
Hem pazarlama sayfalarını hem dokümanları kapsayan basit bir site aramasıyla başlayın. Basit bir çözüm bile yok olmaktan iyidir—özellikle doküman ağırlıklı ürünlerde.
Yayına aldıktan sonra arama davranışını düzenli gözden geçirin ve kanıta göre ayarlayın. Erken kazanım, "sonuç yok" sorgularını eksik sayfalar, eşanlamlılar veya daha iyi başlıklarla düzeltmektir.
Dokümanlara özel arama özellikleri
Doküman araması pazarlama aramasından farklıdır. İnsanlar görev odaklı ve sabırsızdır; küçük UX özellikleri fark yaratır:
- Filtreler (versiyon, ürün alanı, dil, "API" vs "guides")
- Aramaya odaklanma için klavye kısa yolu (ör. / veya Cmd/Ctrl+K)
- Sonuç vurgulama (eşleşen kelimeleri başlıklarda/snippet'lerde gösterme)
İş sorularına cevap veren olayları izleyin
Sayfa görüntülemelerinden fazlasını izleyin:
- Pazarlama sayfalarındaki CTA tıklamaları
- Kayıt başlangıçları ve tamamlanmaları
- Doküman aramaları (sorgu + seçilen sonuç)
- "Sonuç yok" aramaları ve aramadan sonra çıkışlar
Pazarlama ve destek ekiplerinin verilere güvenmesi için adlandırmayı tutarlı yapın ve basit bir iç sayfada (ör. /docs/analytics-events) dokümante edin.
Dashboard'lar ve geri bildirim döngüleri
İki izleyici için hafif dashboard'lar kurun:
- Pazarlama: en iyi açılış sayfaları → CTA tıklamaları → kayıt başlangıçları
- Destek: en çok ziyaret edilen dokümanlar, en çok aranan sorgular, "sonuç yok" ve yüksek bounce'a sahip sayfalar
Ardından döngüyü kapatın: tekrar eden destek biletlerini ve sık yapılan aramaları doküman güncellemelerine, yeni örneklere veya geliştirilmiş sorun giderme bölümlerine dönüştürün. Zamanla dokümanınız destek yükünü azaltan ve dönüşümü artıran kendi kendini onaran bir sistem olur.
Lansman Kontrol Listesi ve Bakım Planı
İyi bir SaaS site lansmanı "yayınla ve umut et" değildir. Kırık sayfalar, eksik meta veriler, bozuk kayıt bağlantıları gibi utandırıcı sorunları müşteriler fark etmeden yakalayacak kontrollerle yapılan kontrollü bir sürümdür—ve pazarlama sayfaları ile dokümanların güncel kalmasını sağlayan bir bakım ritmi.
Lansman öncesi kontrol listesi (küçük ama hayat kurtaran işler)
Duyuru yapmadan önce bütün siteyi inceleyin:
- Kırık bağlantılar: siteyi tarayıp 404'leri düzeltin, özellikle doküman → doküman ve doküman → pazarlama bağlantıları.
- Yönlendirmeler: değişen veya kaldırılan tüm URL'ler için 301 yönlendirmeleri ayarlayın. "Sonra düzeltiriz"e güvenmeyin—eski bağlantılar yer imlerinde, e-postalarda ve arama sonuçlarında kalır.
- Sitemap: /sitemap.xml varlığını ve indekslenmesini istediğiniz pazarlama ve doküman sayfalarını içerdiğini doğrulayın.
- robots.txt: /robots.txt'nin uygun şekilde indekslemeye izin verdiğini ve özel/çoğaltılmış alanları (ör. önizlemeler) engellediğini kontrol edin.
Eski bir siteden taşıma yapıyorsanız, eski URL → yeni URL eşlemesini bir spreadsheet'te tutun ve repository yanında saklayın ki gelecekte orijinal plan üzerine yazılmasın.
Müşterilerin gerçekten kullandığı akışları test edin
Rastgele tıklamak yerine gerçek "iş" akışlarını test edin:
- Fiyatlandırma → kayıt: fiyat sayfası hızlı açılıyor mu, CTA çalışıyor mu, kayıt tamamlanıyor mu, onay e-postaları gidiyor mu?
- Doküman → destek ile iletişim: okuyucu çözüm bulamazsa yardım seçeneklerini hızla bulabiliyor mu, form veya e-posta çalışıyor mu?
- Arama → makale: arama ilgili sonuçlar döndürüyor mu, başlıklar okunabilir mi, seçilen makale niyeti karşılıyor mu?
Bu akışları sürüm engelleyiciler (release blockers) olarak kabul edin. Herhangi bir akış başarısızsa, dönüşümler ve destek hacminde hemen hissedersiniz.
Yönlendirme stratejisi (şimdi ve gelecekte)
Yönlendirmeler sadece migrasyonlar için değildir. SaaS siteleri sürekli evrilir: özellik adlarını değiştirirsiniz, dokümanları yeniden yapılandırırsınız ve sayfaları yeniden yazarsınız.
Bir kural koyun: bir URL'yi ya (a) yönlendirin ya da (b) gerçekten silmek istiyorsanız 410 döndürün. Dokümanlar için genellikle yönlendirme en doğru tercihtir.
Ayrıca ileriye dönük bir URL politikası üzerinde anlaşın (ör. versiyon numaralarını URL'lere koymaktan kaçının, yoksa gerçekten versiyonlayın). Bu, gelecekteki refactor'ları küçültür.
Yayın planı: duyur, izle, hızlı düzelt
Lansman günü için hafif bir planınız olsun:
- Duyuru (e-posta, sosyal, uygulama içi) site canlı doğrulandıktan sonra
- İzleme: analiz, kayıt hunisi düşüşleri, 404'ler ve search console indeksleme hatalarını takip edin
- Hızlı düzeltme: kayıtları, ana dokümanları veya en çok ziyaret edilen sayfaları bozan herhangi bir şeyi önceliklendirin
Mümkünse ilk 24–48 saat boyunca "hotfix penceresi" tutun.
Lansman sonrası bakım ritmi
Basit bir rutin bozulmayı engeller:
- Aylık SEO incelemesi: search console hataları, sıralamada düşüş gösteren sorgular ve gösterim yüksek ama tıklama düşük sayfalar (çoğunlukla başlık/meta sorunudur) kontrolü
- Üç aylık doküman temizliği: güncel olmayan ekran görüntülerini kaldırma, kurulum adımlarının ürünle uyumunu onaylama ve en çok ziyaret edilen dokümanları netleştirme
Bir web sitesi bir ürün yüzeyidir. Ona bir ürün gibi davranın: sürekli iyileştirmeler yayınlayın ve etkisini ölçün.
SSS
How do I set a clear goal for a combined SaaS marketing site and documentation?
Başlangıç olarak hem pazarlama hem de destek sonuçlarını içeren tek cümlelik bir hedef yazın; örneğin: "Nitelikli potansiyel müşterileri dönüştürürken müşterilerin self-servis destek almasını sağlamak." Ardından her sayfaya birincil görev atayın:
- Pazarlama sayfaları: bir sonraki adıma yönlendirme (deneme, demo, fiyatlandırma).
- Dokümantasyon: kayıttan sonra sürtünmeyi azaltma (kurulum, entegrasyon, sorun giderme).
Which audiences should a SaaS marketing + docs site serve?
Çoğu birleşik SaaS sitesi en az dört grup için hizmet eder:
- Uygunluğu, kanıtı ve fiyatlandırmayı değerlendiren potansiyel müşteriler
- İlk "aha" anına ulaşmaya çalışan deneme kullanıcıları
- Kullanım kılavuzlarına ve sorun giderme bilgilerine ihtiyaç duyan müşteriler
- API/SDK ve uygulama ayrıntılarını inceleyen geliştiriciler
Bir sayfanın hedef kitlesini adlandıramıyorsanız, sayfanın kapsamını yeniden yazın.
What’s a simple information architecture that works for both marketing and docs?
Küçük bir üst düzey bölüm seti kullanın, geri kalanını ise footer'a koyun:
- / (ana sayfa)
- /product (veya /features)
- /pricing
- /customers
- /blog
- /docs
Global navigasyon pazarlamaya odaklanmalı; doküman navigasyonu ise dokümanların kenar çubuğuna (Getting started, Guides, API, Troubleshooting) ait olmalı.
Should documentation live at /docs or on a subdomain like docs.example.com?
Çoğu SaaS ürünü için varsayılan olarak /docs altında dokümantasyon barındırmak en iyi seçenektir:
- Kolay çapraz bağlantı ve tutarlı marka deneyimi
- Paylaşılan SEO ve daha basit analizler
Dokümanlar farklı araçlar, izinler veya ayrı bakım iş akışları gerektirecekse ayrı bir alt alan kullanılabilir.
How do I plan URLs so they don’t break later?
URL'leri birer sözleşme gibi düşünün:
- Kısa, insan tarafından okunabilir slugs kullanın (ör.
/docs/sso) - Derin iç içe geçmiş yapılardan kaçının; kullanıcı zihniyetine uyuyorsa örneğin
/docs/integrations/slackuygundur - Bir slug stili seçin ve ona bağlı kalın (kebab-case yaygındır)
- Yeniden yapılandırıyorsanız, ilk günden 301 yönlendirmeleri planlayın
URL kurallarını erken belirleyin, özellikle doküman versiyonlamayı düşünüyorsanız.
What pages should I build first for a SaaS website that includes docs?
Ziyaretçiye ne olduğunu, neye güvenebileceğini ve bir sonraki adımı nasıl atacağını söyleyen sayfaları önceliklendirin.
Minimum pazarlama seti:
- Ana sayfa
- Özellikler/Kullanım durumları
- Fiyatlandırma
- Güvenlik/Trust
- İletişim
Minimum doküman seti:
- Getting started
- Guides
- API reference (varsa)
- Troubleshooting
What tech stack is best for a marketing site plus documentation?
Kimin içerik güncelleyeceğine ve ne sıklıkta güncelleme olacağına göre seçin:
- SSG (Astro/Docusaurus/Hugo/Next static): hızlı, basit barındırma, Markdown dokümanlar için ideal
- Sunucu tarafı veya tam uygulama: kişiselleştirme, yetkilendirilmiş dokümanlar, karmaşık izinler için
- CMS (geleneksel/headless): teknik olmayan ekipler sıkça ve yapısal içerik yayınlıyorsa iyi
Çoğu ekip için yaygın bir hibrit: dokümanlar için Markdown/MDX, pazarlama içeriği için CMS alanları.
How should I structure CTAs and conversion paths across marketing pages?
Her kilit sayfaya birincil ve ikincil CTA verin; terimleri ve yerleşimi tutarlı tutun:
- Ana sayfa: Birincil Start free trial; İkincil See a demo
- Özellikler: Birincil View pricing; İkincil Read how it works
- Fiyatlandırma: Birincil Choose a plan; İkincil Talk to sales
Karar noktalarına yakın kanıt (logolar, referanslar, vaka çalışmaları) ekleyin.
How do I make documentation navigation and structure “obvious” to users?
Tahmin edilebilir bir doküman yapısı ve şablonları kullanın:
- Sidebar kategorileri niyete göre (Getting Started, Tutorials, How-to, Reference, Explanations)
- Uzun sayfalar için sayfa içi içerik tablosu
- İleri/Geri bağlantıları ile akıcı okuma yolu
Her sayfada Problem → Adımlar → Beklenen sonuç → Sorun giderme gibi bir şablon standartlaştırın.
What metrics should I track to continuously improve a combined marketing + docs site?
Sayfa görüntülemeleri tek başına yeterli veriyi vermez. Sonuçlara bağlanan olayları izleyin:
- Pazarlama sayfalarındaki CTA tıklamaları ve kayıt başlangıçları/tamamlanmaları
- Doküman aramaları (sorgu + seçilen sonuç)
- "Sonuç yok" aramaları
- 404'ler ve aramadan sonra yüksek çıkışlar
Aylık gözden geçirme yapın ve tekrar eden aramalar ile destek taleplerini doküman güncellemelerine dönüştürün.