Görevlere değil kararlara odaklanan bir yaklaşım

• Kararlara odaklanmak

  • Every Page Is Page One kitabından bir alıntı, teknik dokümantasyon yazımına yaklaşımda büyük bir değişim yarattı
  • Teknik iletişimde çoğunlukla görev desteğinden söz edilir; ancak çoğu durumda insanların bir görevi tamamlamak için ihtiyaç duyduğu bilgi, makinenin nasıl çalıştığına dair değil, karar vermeyi destekleyen bilgidir
  • Yalnızca prosedürleri belgelendirmek yeterli değildir
  • Kullanıcılara hangi kararları vermeleri gerektiğini ve bunun sonuçlarının ne olacağını anlatmalı, mümkün olduğunca onları karar vermeyi destekleyen kaynaklara ve referanslara yönlendirmeliyiz

GN⁺ Özeti

• Bu yazı, teknik dokümantasyon yazımında karar desteğinin önemini vurguluyor
• Sadece prosedürleri açıklamanın ötesine geçip, kullanıcıların daha iyi kararlar almasına yardımcı olmak gerekiyor
• Teknik yazarlar için, kullanıcıya ihtiyaç duyduğu bağlamı ve bilgiyi sağlamak önemli
• Benzer işlevlere sahip sektördeki projeler arasında Confluence ve Notion öneriliyor