Markdown'da eksik alternatif metni gözden kaçırmak kolaydır çünkü kaynak hâlâ eksiksiz görünebilir. Görüntü sözdizimi mevcut, dosya yolu mevcut ve belge, ekran görüntüsü görünür şekilde oluşturulabilir. Eksik kısım parantez içindeki metindir.
Teknik yazarların yayınlamadan önce bunu yakalaması gerekir. Converty'nin Markdown Doğrulayıcısı diğer yazma uyarılarıyla birlikte eksik alt metni ortaya çıkarabilir, böylece kaynağın düzeltilmesi hala kolayken sorun görünür hale gelir.
Markdown'da neden eksik alternatif metin gizleniyor?
Markdown görselinin sözdizimi şuna benzer:
Açıklama eksik olduğunda resim yine de oluşturulabilir:
Bu, görsel tarama sırasında sorunun gözden kaçırılmasını kolaylaştırır. Sayfa, yazara iyi görünebilir ancak kaynak, metin alternatiflerine güvenen okuyucular ve görselin rolünü anlamaya çalışan incelemeciler için yararlı bağlamı kaybetmiştir.
Önizleme geçişi sırasında görüntüleri kontrol edin
Pratik bir dokümanlar iş akışı, görsel odaklı bir inceleme adımı içermelidir:
- İşaretlemeyi Markdown Doğrulayıcıya yapıştırın.
- Görüntünün göründüğünü onaylamak için oluşturulan önizlemeyi inceleyin.
- Eksik alternatif metin için uyarı listesini okuyun.
- Kaynağa dönün ve görselin amacını açıklayan kısa bir açıklama yazın.
- Yayınlamadan veya işleme koymadan önce belgeyi yeniden kontrol edin.
Bu, bir incelemecinin sorunu bir çekme isteğinde veya yayınlanan sayfada yakalamasını beklemekten daha hızlıdır.
İyi alternatif metin bağlama bağlıdır
Alternatif metin, görselin belgede neden önemli olduğunu açıklamalıdır. Bir CSV doğrulayıcının ekran görüntüsü, açıklanan her görünür piksele ihtiyaç duymaz. Doğrulayıcının yinelenen başlık uyarılarını veya içe aktarılan satırların ayrıştırılmış önizlemesini gösterdiğini söylemesi gerekebilir.
En iyi açıklama çevredeki metne bağlıdır. Paragraf görüntüyü tam olarak açıklıyorsa alternatif metin kısa olabilir. Resim yeni bilgiler taşıyorsa alternatif metin bu bilgilerin korunmasına yardımcı olmalıdır.
Alt kontrollerini daha geniş Markdown QA ile eşleştirin
Eksik alternatif metin, birkaç yazım sorunu arasında yer alan bir sorundur. İyi bir önizleme geçişi aynı zamanda başlık yapısını, bağlantıları, tabloları ve kod çerçevelerini de kontrol etmelidir.
Daha geniş bir iş akışı için Yayınlamadan Önce Markdown Sorunları Nasıl Yakalanır? konusunu okuyun. Ekip incelemesi için Ürün ve Dokümanlar Ekipleri Biçimlendirmeyi Kaybetmeden Markdown'ı Nasıl İnceleyebilir? konusunu kullanın.
Ekran görüntüleri veya diyagramlar belgenin parçası olduğunda Markdown'ı yayınlamadan önce Markdown Doğrulayıcıyı açın.
