1 yorum

 
GN⁺ 2024-12-15
Hacker News yorumu
  • Bu yazıyı beğenenler, etkili bir doktora tezi yazım süreci hakkında daha fazla bilgi edinmek istiyorsa [1] numaralı konuşmayı izlemeli. Bu video, iletişim becerilerini geliştirmek isteyen herkes için faydalı ve ücret ödemeye de değer

  • Tez yazarken bana yardımcı olan iki kaynak, Paul R. Halmos'un "How to Write Mathematics" ve Donald E. Knuth ve diğerlerinin "Mathematical Writing" eserleriydi

    • Halmos'un kitabı, açık ve doğru iletişimi hedeflemeye yardımcı oluyor
    • Knuth ve diğerlerinin ders notlarındaki "Bad/Better/OK" önerisi özellikle aklımda kalmıştı
    • Üçüncü adım olarak önerilen linter, hata olduğunda faydalı olabilir
    • Bu kaynaklar, tanım içeren konular hakkında yazan herkes için vazgeçilmez
  • Birçok örneğe katılmıyorum

    • Örneğin, "çok zor" ifadesi "zor" ile aynı anlama gelmiyor
    • Çeşitli yöntemlerin kullanıldığı bilgisi ikinci cümlede eksik kalmış
  • Bash betiğini bir web UI'ye taşıdım; böylece kodu doğrudan yapıştırıp sonucu görebiliyorsunuz

  • vale.sh ile stil yönergeleri eklenebiliyor

    • PR sırasında vale çalıştıran bir GitHub Action kullanıyorum
    • Stili zorunlu kılmada yararlı ama ondan tam anlamıyla faydalanmıyorum
  • İlk Unix sürümlerinde benzer işler yapan <i>diction</i> ve <i>style</i> komutları vardı

    • GNU'da bu komutlar edinilebiliyor ve homebrew'de de var
    • Hatırladığım kadarıyla pek iyi değillerdi; bu programlar da benzer performans gösteriyor
  • Bir makaleyi pazarlamak için, fikrin kaynak ayrılmaya değer olduğuna insanları ikna etmeniz gerekir

    • Yazarın dediği gibi, önemsiz bir yazım hatası belirleyici unsur olabilir
    • Nesnellik varmış gibi yapmayıp, editörün zevkini ve görüşlerini yansıtan dergileri kabullenmek gerekir
    • Her şeyi arxiv gibi standart mecralarda yayımlayabilirsiniz
  • Benim alanımda yazının kalitesi en önemli şey değildi

    • Lisansüstü öğrencileri, açık ve öz yazı yazmaktan ziyade topluluk önünde konuşma becerilerini geliştirmekten daha çok fayda görebilir
    • Özellikle düşmanca sorularla karşılaşıldığında çok işe yarar
  • Tüm teknik belgelerde zarfları kaldırmak olumlu olabilir

    • Stephen King de zarflardan hoşlanmaz
    • Ancak tüm zarfları kaldırmak zor olabilir
    • "randomly" gibi zarflar cümlede önemli bir rol oynar
  • İlgili kaynaklar:

    • <i>Shell scripts to improve your writing</i> - Ocak 2017
    • <i>Shell scripts to improve your writing, or "My advisor rewrote himself in bash."</i> - Temmuz 2010