İlk bakışta anlaşılan bir talimat nasıl oluşturulur
İyi bir adım adım talimat, belirsizlikleri ve gereksiz teoriyi ortadan kaldırarak kullanıcıyı en az sayıda işlemle sonuca götürür. Metnin işe yaraması için emir kipini kullanın («Tıklayın», «Tıklanması gerekir» yerine), karmaşık süreçleri mikro adımlara bölün ve her aşamayı görsel ipuçlarıyla destekleyin. Ana kural: bir adım — tek bir somut eylem.
Temel ilke: Talimat, yazarın uzmanlığını sergilemek için değil, kullanıcının sorununu minimum sürede çözmesi için yazılır.
Hazırlık: Hedefi ve kitleyi belirleyin
İlk adımı yazmadan önce şu üç soruyu yanıtlayın:
- Nihai hedef nedir? (Kullanıcı sonunda ne elde etmeli?)
- Okuyucu kim? (Temel terimlerin açıklanması gereken bir yeni başlayan mı, yoksa hızın önemli olduğu bir uzman mı?)
- Görev hangi bağlamda gerçekleştiriliyor? (Yolda mobil cihazdan mı, yoksa ofiste masaüstünden mi?)
Beklenen sonucu net bir şekilde ifade edin. Örneğin: «Talimatı tamamladıktan sonra hesabınız oluşturulacak ve onay e-postası adresinize gelecektir». Bu, kullanıcının kaygısını azaltır; sürecin ne zaman başarıyla tamamlandığını bilir.
İdeal talimatın yapısı
Mantıklı bir yapı, kullanıcının metinde yön bulmasına yardımcı olur. Aşağıdaki şablonu kullanın:
- Giriş. Ne yaptığımızı ve neden yaptığımızı kısaca (1–2 cümle) açıklayın.
- Gereksinimler. Yanınızda nelerin olması gerektiği (erişim bilgileri, yüklü programlar, kart verileri).
- Adım adım algoritma. İşlemlerin numaralı listesi.
- Sonucun doğrulanması. Her şeyin doğru yapıldığından nasıl emin olunacağı.
- Sorun giderme (Troubleshooting). Bir şeyler ters gittiğinde ne yapılacağı.
Talimat uzunsa (10 adımdan fazla), başına bir içerik tablosu ekleyin. Bu, deneyimli kullanıcının temeli atlayıp hızlıca gerekli aşamaya geçmesini sağlar.
Adımları yazma kuralları (UX yazarlığı)
Talimatın kalitesi, her bir adımın kalitesiyle belirlenir. Bu kurallara uyun:
1. Tek eylem — tek adım
Bir maddede birden fazla işlemi karıştırmayın.
- ❌ Kötü: Ayarlara girin, profili seçin ve şifreyi değiştirin.
- ✅ İyi:
- Ayarlar bölümüne gidin.
- Profil öğesini seçin.
- «Yeni şifre» alanına kombinasyonu girin ve Kaydet düğmesine tıklayın.
2. Fiille başlayın
Emir kipini kullanın. Bu, yer tasarrufu sağlar ve metni dinamik hale getirir.
- ❌ Kötü: Dosya menüsünü açmanız gerekir.
- ✅ İyi: Dosya menüsünü açın.
3. Soyutlamalar yerine somutluk
«Bir yerde», «yaklaşık», «genellikle» gibi kelimelerden kaçının. Düğmelerin, menülerin ve alanların tam adlarını belirtin. Arayüz öğelerini hızlı okumada dikkat çekmeleri için kalın yazı tipi veya monospace yazı tipi ile vurgulayın.
4. Görsel destek
Resimsiz metin daha zor algılanır.
- Karmaşık arayüzler için ekran görüntüleri ekleyin.
- Ekran görüntülerinde etkileşime girilmesi gereken öğeyi ok veya çerçeve ile vurgulayın.
- Görsellere açıklama ekleyin (örneğin: Şekil 1. Oturum açma penceresi).
Karmaşık senaryolarla çalışma
Tüm süreçler doğrusal değildir. Süreçte koşullar varsa («eğer... ise...»), bunları açıkça biçimlendirin.
Tablo: Dallanmalar nasıl biçimlendirilir
| Durum | Metinde nasıl biçimlendirilir |
|---|---|
| Basit koşul | Adım içinde madde işaretli liste kullanın: «Sistem kod isterse, SMS'teki kodu girin». |
| Alternatif yol | Ayrı bir H3 alt başlık olarak vurgulayın: «Google ile alternatif giriş yöntemi». |
| Hata | Sorunlu adımdan hemen sonra hatanın açıklamasını ve düzeltme yöntemini içeren bir :::warning bloğu ekleyin. |
Yaygın hata: Önemli uyarıları uzun metnin sonuna gizlemek. Eylem geri alınamazsa (veri silme, ödeme), bunu eylem gerektiren adımdan önce belirtin.
Talimat kalitesi kontrol listesi
Yayınlamadan önce metni şu filtreden geçirin:
- [ ] «Kör» kullanıcı testi. Talimatı süreç hakkında bilgisi olmayan birine verin. Soru sormadan görevi tamamlayabilir mi?
- [ ] Boş sözlerin olmaması. «Modern teknoloji dünyasında önemlidir...» gibi giriş ifadeleri kaldırıldı mı?
- [ ] Terim tutarlılığı. Aynı öğeyi belirtmek için aynı kelime mi kullanılıyor (bir sefer «düğme», sonra «tuş», sonra «bağlantı» değil)?
- [ ] Ekran görüntülerinin güncelliği. Görseller mevcut arayüz sürümüyle uyumlu mu?
- [ ] Bağlantıların çalışır durumda olması. Tüm dahili geçişler doğru bölümlere mi yönlendiriyor?
SSS: Talimatlar hakkında sık sorulan sorular
Pratikten önce teori açıklamak gerekir mi? Sadece anlayış için kritik derecede önemliyse. Çoğu durumda kullanıcı sonuç ister, temel eğitim değil. Teoriyi ayrı bir makaleye taşımak veya spoiler altında gizlemek daha iyidir.
Arayüz sık sık değişiyorsa ne yapılmalı? Mümkünse düğmelerin rengi veya konumuna bağlı kalmaktan kaçının. Menü öğelerinin adlarını kullanın. Değişiklikler sık oluyorsa, ekran görüntülerini mümkün olduğunca genel yapın veya şematik illüstrasyonlar kullanın.
Talimatlarda mizah kullanılabilir mi? Dikkatli olun. Hafif bir ton kabul edilebilir, ancak stresli bir durumda olan (örneğin hesap erişimini kurtarmaya çalışan) kullanıcıyı şakalar rahatsız edebilir. Öncelik netlik ve empatidir.
Bir adım uzun süre beklemeyi gerektiriyorsa ne yapılmalı? Bunu önceden belirtin. Örneğin: «Yükleme 5 dakikaya kadar sürebilir. Sekmeyi kapatmayın». Bu, panik ve tekrarlanan tıklamaları önler.