Yazar, tcpdump ve dig gibi sıkça kullanılan komut satırı araçlarının man page'lerini (kılavuz sayfalarını) geliştirmeye odaklandığını belirtiyor. Geçtiğimiz ay man page'lerdeki örneklerin ne kadar değerli olduğunu fark etmesiyle bu projeye başladığını ifade ediyor. Amacı, bu araçları nadiren kullanan veya daha önce hiç kullanmamış kişiler için en temel kullanım örneklerini sunarak, kullanıcıların işlerini kolaylaştırmak ve araçların işleyişini hatırlamalarına yardımcı olmaktır. Bu yaklaşımın, kullanıcı geri bildirimleriyle de desteklendiğini ve bakımcılar tarafından da ilgi çekici bulunduğunu ekliyor.
Yazar, resmi dokümantasyon üzerinde çalışmaya ilgi duymasının birkaç nedenini açıklıyor. Öncelikle, man page'lerin neredeyse %100 doğru bilgi içerebilmesi, titiz bir inceleme sürecinden geçmeleri sayesinde büyük bir değer taşıyor. İkinci olarak, bakımcıların genellikle kullanıcıların bilmediği faydalı özelliklerin farkında olduğunu belirtiyor. Örneğin, tcpdump örnekleri üzerinde çalışırken, tcpdump -w out.pcap ile paketleri bir dosyaya kaydederken -v parametresini kullanarak yakalanan paketlerin canlı özetini görmenin ne kadar kullanışlı olduğunu öğrendiğini paylaşıyor. Bu tür bilgilerin, kendi başına keşfetmesinin zor olacağını vurguluyor.
Yazar, genel olarak dokümantasyonun okunmasının zor olduğunu varsayma eğiliminde olmasına rağmen, şu anda bu konuda iyimser olduğunu ifade ediyor. Dokümantasyonun kötü olmak zorunda olmadığını, hatta iyi bir blog yazısı kadar bilgilendirici ve aynı zamanda doğru olabileceğini düşünüyor. tcpdump projesinin man page'inin roff dilinde yazılmış olmasının getirdiği zorluğa da değiniyor. roff dilini öğrenmek istemediği için, Markdown'ı roff'a dönüştüren basit bir betik yazarak bu sorunu aştığını belirtiyor. Bu, mevcut man page'deki kurallara benzer bir yaklaşımla yapılmış.
Resmi dokümantasyonun, özellikle temel kullanım örnekleri ve gizli özellikler açısından, kullanıcılar için ne kadar değerli olabileceğini gösteriyor.