Yazar, geçen yıl Git man page'leri üzerinde çalıştıktan sonra iyi bir man page'i neyin oluşturduğu üzerine düşünmeye başlamıştır. tcpdump, git, dig gibi araçların birincil dokümantasyonu olan man page'leri genellikle karmaşık bulduğu için bu araçlar için sık sık kopya kağıtları (cheat sheets) hazırladığını belirtiyor. Bu deneyimlerden yola çıkarak, man page'lerin kendilerinin harika bir kopya kağıdı içerip içeremeyeceğini ve daha kolay kullanılabilir hale nasıl getirilebileceğini sorguluyor. Henüz düşüncelerinin başında olsa da, bu konudaki ilk notlarını paylaşmak istiyor. Yazar, Mastodon'da insanlara favori man page'lerini sorduğunda ilginç örneklerle karşılaşmıştır. rsync man page'i, SYNOPSIS bölümünü çok kısa tutarak ve ardından her seçeneğin tek satırlık özetini içeren bir "OPTIONS SUMMARY" bölümü sunarak dikkat çekiyor. Bu, uzun seçenek listelerinin okunabilirliğini artırıyor. Bir diğer örnek ise strace man page'i; bu man page, seçeneklerini alfabetik yerine "Genel", "Başlangıç", "İzleme", "Filtreleme" ve "Çıkış Biçimi" gibi kategorilere göre düzenleyerek kullanıcıların aradıkları bilgiye daha kolay ulaşmasını sağlıyor. Yazar, grep man page'ini bu kategori bazlı özetleme denemesine tabi tutmuş ve sonuçları değerlendirmiştir. Perl'in man page'leri (örneğin perlcheat), SYNTAX gibi bölümlerde yoğunlaştırılmış, 80 karakter genişliğinde kopya kağıdı tarzı bölümler sunarak önemli bir kullanım kolaylığı sağlıyor. Bu, yazarın man page'lerde daha fazla bu tür yoğunlaştırılmış bilgi formatlarının kullanılıp kullanılamayacağını düşünmesine yol açmıştır. Ayrıca, kullanıcıların ortak geri bildirimlerinden biri de "örnek içeren man page'leri severim" olmuştur. OpenBSD tail man page'i gibi örnekler içeren man page'lerin, kullanıcıların bir komutu nasıl kullanacaklarını hızlıca anlamalarına yardımcı olduğu vurgulanmıştır. Bu notlar, man page'lerin kullanıcı deneyimini iyileştirmek için farklı yaklaşımları ve potansiyel çözümleri ortaya koyuyor.
Man page'lerin okunabilirliğini ve kullanılabilirliğini artırarak teknik dokümantasyonun erişilebilirliğini önemli ölçüde geliştirebilir.