Teknik blogları nasıl yazarsınız? [kapalı]

Genellikle programlama ile ilgili şeyler hakkında çok şey okurum. Okuduğum konu işimle doğrudan ilgili olmadığında (günlük işlerde kullanmadığım bazı algoritmalar hakkında okuma diyelim), onları unutuyorum.

Öğrenilmiş olanı pekiştirmenin bir yolu blog yazmaktır. Ben blog yazmaya yeni başlıyorum. Yazmaya başladığımda bunun çok zor olduğunu anladım. İçeriği basitçe çoğaltmak bile yaklaşık iki saat sürer. Blog hakkında iyi düşünülmüş bir yazı yazmak çoğu zaman bütün bir gün veya bazen bir hafta sonu alabilir.

Bu normal mi? Teknik öğreticiler / teknik bloglar yazmak için herhangi bir ipucu?

Yazmak zordur, iyi yazmak daha zordur. Bir şeyi açıklamaya çalışmakla ilgili olan şey, daha fazla bilgi gerektirmesi ve sonra sadece “bilmesi” gerektiğidir. Blog yazarak 1. anladığım gereken ilgili konuları buldum, 2. anlayışımın sığ olduğunu tanımladım.

Bu slaytları okuyun: http://www.ai.uga.edu/mc/WriteThinkLearn.pdf . Yazma hakkında çok şey anlatıyorlar (ve hatta bunu programlama ile karşılaştırıyorlar)

Her kalite çalışması zaman ve çaba gerektirir. Beklenilmesi bekleniyor.

Eski blog yazılarımdan bazılarının tamamlanması yaklaşık 3 hafta sürdü. Bir taslak yazarsın, yeniden okur, gerekli düzeltmeleri yaparsın, tekrar tarayın ve sonra provaları okuyun. O zaman alır.

Kendinizi motive etmek için nasıl basit bir fikir. Büyük bir şey planlıyorsanız, işi 2-3 parçaya ayırıp ayrı olarak yayınlamanın mantıklı olacağını düşünün. Elbette ki parçaların okuyucularınız için kendi başlarına yararları gerekir. O zaman daha az zaman harcadıklarından, bunu yapıp kısmi çalışmayı tamamlama ihtimaliniz daha yüksektir.

Bu bilinmeyen teknik blogcudan bazı ipuçları:

• Önizlemeden komut satırına veya çalıştırılacak bir metin dosyasına kesip yapıştırarak girdiğiniz kodu doğrulayın (yalnızca okuyun). Bir editörden (veya kabuktan) bir web sayfasına geri dönerken ve geri dönerken birkaç şey (satır sonları, girintiler ve Unicode karakterleri gibi) karışabilir.
• Yazım, dilbilgisi ve içeriğini kontrol etmesi için bir insan edin - Makaleleri doğru ve okunması kolay hale getirmek için bir miktar çaba harcadığını gösterir. Çevrede kimse yoksa, yayınlamadan önce makalenin tamamını yeniden okuduğunuzdan emin olun.
• Blog platformunda sözdizimi vurgulama varsa , kullanın. Değilse, kodu kendisine ait olan bir yere gönderin ve buraya bağlayın.
  • Sonuç: Büyük kod parçalarını makale metninden uzak tutun. Bu biraz belirsizdir, ancak metin bazı kodların nasıl çalıştığını açıklıyorsa, bir snippet eklemek iyi bir şeydir. İndirilecek bir yazılım parçası sunuyorsa, bir VCS web arayüzüne atıfta bulunmak daha iyidir.
• Her makale kendi başına okunabilir olmalıdır . Başka makalelere atıfta bulunmak iyidir, ancak okuyucunun bundan önce başka yayınları okuduğunu varsaymayın.
• Anlamaya yardımcı olurken metinden başka formatlar kullanın . Bazı şeyler için kod yeterli, ancak bazıları için bir görüntü veya hatta animasyon çok daha anlaşılabilir olabilir.

Çoğu zaman zor bir blog gönderisinin çok uzun sürdüğünü ve araştırma gerektirdiğini biliyorum; Bu araştırma sadece blog yayınınıza yardımcı olmakla kalmaz, aynı zamanda süreçte kendi kişisel bilgilerinizi geliştirmenize yardımcı olur. Dediğiniz gibi, yazıyı yazarak bilgiyi pekiştiriyorsunuz; ayrıca bilginizi genişletiyorsunuz. İhtiyaç duyduğu zamanı kucaklayın ve bir öğrenme deneyimi olarak değer verin.

Evet, teknik blog yazımının zaman alması normaldir . Benim için yazı en kısa süreyi alıyor (bir saate kadar kısa ya da uzunluğa bağlı olarak bir güne kadar). Sonra düzenleme ve yeniden yazma genellikle daha uzun sürer (iki veya üç güne kadar). Zaman aldığı belirtilen bir diğer özellik, herhangi bir örnek kodun açıklığa kavuşturulmasıdır. Ayrıca, konularım için destekleyici bağlantılar bulmak için zaman harcamayı seviyorum. Hepsi zaman alıyor!

Sanırım şimdi teknik blog yazabiliyorsunuz. Ama belirli bir alanda uzman olduğunuzda bunu yapmanızı öneririm. Bir hafta sonu geçirmek çok fazla bir zaman değil. hepsi konunun karmaşıklığına bağlıdır. Sanırım söylediğim şey şuyunuzun çekirdeğinin doğal olarak size gelmesidir. Yürütme daha uzun sürebilir.

İnsanlar bir blogda bazı uzman tavsiyeleri arıyorlar .. noobs deneyleri değil. ama genel anlamda konuşuyorum .. Size blog yazmaktan caydırmak istemiyorum. Ancak aşağıdakileri aklınızda bulundurun.

1. Blogunuz yeni bir şey söylemeli. Sadece veri toplamak ve kendi blogunuza koymak değil

2. Ne söylediğinizden kesinlikle emin olun, yani güçlü deneysel sonuçlara ya da ilk elden deneyimlediğiniz deneyimlere veya testlere bağlı kalın .

3. Eleştiriye hazır olun.

4. bilgi teknikleri yazma bloglar (doğruluk, özlü, vs)

5. Bir şeyler yaz çünkü sen o yazılmalıdır shud düşünüyorum; Bunu düşünmüyor çünkü edecektir okunabilir.

Tarzın Unsurları

Bence teknik yazı, yazı ile aynı kurallara uyuyor. Yazma hakkında yalnızca bir kitap okursanız, klasik Strunks " Stilin Öğeleri" olmalıdır . Kompozisyonunuzu geliştirecek şeylerin bir listesini içerir, en önemlisi (IMO), "Gereksiz kelimeleri ihmal et".

Ayrıca Stephen King'in " Yazmalarını " öneririm . Kurgusal yazı hakkında daha fazla bilgi sahibi olmakla birlikte, özellikle düzenleme ve yazma süreci gibi alanlarda, gelecek vaat eden bir yazar için hala bol miktarda taş içerir.

Teknik yazı ile ilgili zor olan şey söylenmek, gerçek yazı değil, yazdığınız şey hakkındaki düşüncelerinizi açıklığa kavuşturmaktır. Karışmış düşünme kötü yazıma yol açar. İyi yazma, konunuz hakkında net bir anlayışa sahip olmanızı gerektirir; bu nedenle öğretme ve yazma, bir konuyu çözmenin mükemmel bir yoludur.

Blog yazılarını yazmak benim için çok zaman alıyor, evet. Onları sık sık birkaç gün yazıyorum, hatta birkaç hafta boyunca taslak formda bırakıyorum, ara sıra yeniden okudum ve burada ve orada biraz düzeltip ayarladık.

Zaman alıyor, ancak bir şey yazmanın bedeli daha sonra utanmadığım bir şeye değerse, buna değer.