Bu sayfada, Google Dokümanlar Sezonu için kabul edilen bir teknik yazım projesinin ayrıntıları yer almaktadır.
Proje özeti
- Açık kaynak kuruluşu:
- TheGoodDocsProject
- Teknik yazar:
- Sohbetkârlık
- Projenin adı:
- Bilgi mimarisi kılavuzu
- Proje uzunluğu:
- Standart uzunluk (3 ay)
Proje açıklaması
Bilgi Mimarisi Rehber Planı
Bu dokümanda, İyi Dokümanlar Projesi için bir bilgi mimarisi kılavuzu planlaması ele alınmaktadır. Bu belge, Google Dokümanlar 2020 Mevsimi gönderiminin bir parçası olarak hazırlanmıştır. Önerilen kılavuzun kullanım alanını özetler ve planlama amacıyla bu tür bir kılavuzun yapısının bir taslağını çizer.
Bilgi mimarisi (IA), içeriğin nasıl düzenlendiğiyle ilgilidir. İçeriğin yapısını ele alır ancak içeriğin stilini veya kullanılan kelimeleri tanımlamaz. Örneğin, bir IA planında okuyucunun kim olduğu, içeriğe nasıl yaklaştığı ve içeriği okuduğu ortam dikkate alınır. Ardından, bu okuyucu gereksinimlerini en iyi şekilde karşılayacak içerik için uygun bir yapı düşünülür.
İdeal bir durumda, dokümanlar, dokümanların hedeflerini tanımlamak için işletme hedeflerini kullanan bir içerik stratejisiyle tasarlanır. Ardından içerik stratejisi, dokümanların düzenini ve yapısını tanımlayan bir IA oluşturmak için kullanılır. Buradan araç zincirleri seçilebilir ve içerik yazılabilir. Çoğu açık kaynak projesinde içerik stratejisi, "Kullanıcıların bu projeyi nasıl kullanacağını bilmesini sağlayacak dokümanlar yazın" kadar basittir. Ancak bu basit strateji bile etkili bir kullanıcı arayüzü tanımlamak için yeterlidir.
Bu kılavuzun amacı, profesyonel olmayan yazarların hangi şablonları kullanmaları gerektiğini belirlemek için yeterli bir IA geliştirmelerine olanak tanıyan basitleştirilmiş bir araç sağlamaktır. Sıradan bir kullanıcının bir öğleden sonra tamamlayabileceği kadar basit olmalı ve eğitimden çok işleme odaklanmalıdır. Bu yöntemde kavramları kısa ve öz bir şekilde tanıtacak, okuyucuyu bu kavramları kendi projesiyle bağlantılı olarak düşünmeye yönlendirecek ve bunun sonucunu bir sonraki kavrama geçmek için kullanacak.
Okuyucuların İyi Dokümanlar Projesi'ne nasıl başlayacaklarını anlamaları ve şablon seçimlerini yönlendirmek üzere IA kılavuzunu etkili bir şekilde kullanabilmeleri için BENİOKU projesinde bazı güncellemeler yapılması bu proje için gereklidir.
Birincil kitle
Projeleri için doküman oluşturmak amacıyla Good Docs Project şablonlarını kullanmak isteyen herkes
Kullanım alanları: Bu bölüm, okuyucuların IA Kılavuzu'na nasıl yaklaştığını keşfetmek için tasarlanmıştır. Bu, bu okuyuculara en iyi şekilde hizmet verebilmek için rehberin nasıl yapılandırılması gerektiğini belirlememize yardımcı olabilir.
Senaryo: Bir kullanıcı, dokümanı az olan veya hiç olmayan ya da kötü düzenlenmiş ya da yazılmış bir açık kaynak projesi üzerinde çalışıyor. Dokümanları için İyi Dokümanlar Projesi'ni kullanmaya karar veriyorlar ancak nereden başlayacaklarından emin değiller. Şablonları kullanmaya nasıl başlayacaklarını anlamak için BENİOKU bölümünü takip ederler. İçerik stratejisini geliştirmek ve doküman paketlerinin nasıl görüneceğini planlamak için Information Architecture Guide makalesindeki adımları izlerler.
Teklif
BENİOKU bölümünü, açık ilk adımlar dahil olmak üzere yeni okuyucuya proje boyunca daha net bir şekilde rehberlik edecek şekilde güncelleyin. Bu ilk adımlardan biri, yeni bir yapay zeka rehberindeki soruları okuyup yanıtlamaktır. Bu kılavuzda, okuyucuyu kitle, içerik şeması, kullanıcı/görev matrisleri vb. konuları düşünmeye davet ederiz. Ancak okuyucunun bu konuları akademik açıdan öğrenmesi/anlaması için çok fazla yük yüklemeyiz. Bu görev tamamlandığında okuyucu, hangi şablonların gerekli olduğunu ve bunların en iyi şekilde nasıl doldurulacağını anlamış olur.
Research
Bu konuyu araştırmalarla desteklemek için Abby Covert'in kitabına (http://www.howtomakesenseofanymess.com/) çok güveniyorum. Bunun bir nedeni, bu kitabı çok iyi bildiğim ve daha önce yazdığım ve kullanacağım birçok içeriğin temelini oluşturduğu için, diğeri ise IA'ya yeni başlayanların daha fazla bilgi edinmek için bu kitabı kolayca okuyabilmesidir. Bu açıdan bakıldığında yapay zeka için bir geçiş ilacıdır.
Draft ToC
BENİOKU:
-- İyi Dokümanlar Projesi'ne Giriş |_ Şablonları kimler kullanmalıdır? |_ Şablonların işleyiş şekli |_ Projeye katkıda bulunma -- Şablonlar |_ Mevcut tüm şablonların listesi |_ Hangi şablonları kullanacağınızı seçme |_ Başlamadan önce -- Yazmaya başlamadan önce |_ Dokümanları kimler okur? |_ Kullanıcılar dokümanları neden okur? |_ Okuyucularınız için yazma
IA Kılavuzu:
-- Giriş |_ IA nedir? |_ Bu özelliğin bana sağladığı avantajlar neler? -- Dağınıklığı tespit edin -- Niyetinizi belirtin -- Gerçeklerle yüzleşin -- Yön seçin -- Mesafeyi ölçün -- Yapıyla oynayın -- Ayarlamaya hazırlanın