Como você escreve blogs técnicos? [fechadas]

27

Eu costumo ler muito sobre coisas relacionadas à programação. Quando o tópico que leio não está diretamente relacionado ao meu trabalho (por exemplo, lendo sobre alguns algoritmos que não uso no trabalho cotidiano), esqueço-os.

Uma maneira de reforçar o que foi aprendido é escrever blogs. Eu sou iniciante em escrever blogs. Quando comecei a escrever, descobri que é muito difícil. Até simplesmente reproduzir o conteúdo leva cerca de duas horas. Escrever um bom pensamento sobre o blog geralmente leva um dia inteiro ou, às vezes, um fim de semana.

Isso é normal? Alguma dica para escrever tutoriais técnicos / blogs técnicos?

Vinoth Kumar CM
fonte
use mais exemplos (que podem ser copiados e elaborados
imediatamente
em vez de chamá-lo de um blog chique, basta chamá-lo de Vinoths Notebook.
Estou contigo. Tenho cerca de 100 rascunhos no meu blog que iniciei e nunca pareço ter tempo com minhas obrigações de trabalho para entrar em forma de publicação. Não sei como os blogueiros que publicam várias vezes por semana fazem isso sem torná-lo um emprego em período integral.
precisa saber é o seguinte

Respostas:

24

Escrever é difícil, boa escrita é ainda mais difícil. A questão de tentar explicar alguma coisa é que ela requer mais conhecimento do que apenas "meio que sabe disso". Acho que através dos blogs 1. descubro tópicos relacionados que preciso entender, 2. identifico onde meu entendimento é superficial

Leia estes slides http://www.ai.uga.edu/mc/WriteThinkLearn.pdf . Eles explicam muito sobre escrever (e até comparam com programação)

Patrik Björklund
fonte
Vou acrescentar que o mesmo se aplica ao escrever um livro ou geralmente tentar explicar o que seu cérebro apenas 'agrada' a um público mais amplo. Apenas lembre-se sempre tentar usar uma muleta (por exemplo, por que o leitor quer saber este bocado de info)
Martijn Verburg
1
+1 Mark Twain disse: " Eu não tive tempo de escrever uma carta curta, então escrevi uma longa. " O argumento dele era que escrever curta envolve escrever muito e editar.
Ross Patterson
1
@RossPatterson: answers.google.com/answers/threadview?id=177502 Mark Twain provavelmente não foi a fonte dessa citação.
whatsisname 25/01
18

Todo trabalho de qualidade requer tempo e esforço. É de se esperar.

Alguns dos meus escritos mais antigos levaram cerca de três semanas para serem concluídos. Você escreve um rascunho, relê-o, faz as correções necessárias, digitaliza-o novamente e depois o lê. Leva tempo.

Uma idéia simples de como se manter motivado. Se você planeja algo grande, considere se faria sentido dividir o trabalho em duas ou três partes e publicá-las separadamente. Obviamente, as partes precisam ser úteis para os seus leitores. Então, como eles levam menos tempo, é mais provável que você realize e conclua o trabalho parcial.


fonte
6
+1: o problema dos blogs técnicos é que eles não são realmente blogs. Um "blog" técnico é realmente uma coleção de ensaios. Exatamente como você descreveu aqui.
Joel Etherton
7

Algumas dicas deste blogueiro técnico desconhecido:

  • Verifique (não apenas leia) o código digitado recortando e colando da visualização para a linha de comando ou um arquivo de texto a ser executado. Várias coisas (como finais de linha, recuo e caracteres Unicode) podem ser confusas ao transferir de um editor (ou shell) para uma página da Web e vice-versa.
  • Peça a um ser humano que verifique a ortografia, gramática e conteúdo - isso mostra que houve algum esforço para tornar os artigos corretos e fáceis de ler. Se não houver ninguém por perto, leia novamente o artigo inteiro antes de publicar.
  • Se a plataforma de blogs possui destaque de sintaxe , use-o. Caso contrário, publique o código em algum lugar que o possua e vincule-o.
    • Corolário: mantenha grandes quantidades de código longe do texto do artigo. Isso é um pouco vago, mas se o texto está explicando como funciona algum código, é bom incluir um trecho. Se estiver apresentando um software para ser baixado, é melhor consultar uma interface da Web VCS.
  • Cada artigo deve ser legível por si só . Fazer referência a outros artigos é bom, mas não presuma que o leitor tenha lido outras postagens antes desta.
  • Use outros formatos além do texto quando eles ajudarem a compreensão. Para algumas coisas, o código é suficiente, mas para algumas, uma imagem ou mesmo animação pode ser muito mais compreensível.
l0b0
fonte
1
Tudo o que você estiver usando como software de blog, verifique se há um print.css para ele. Isso garante que apenas o conteúdo da postagem seja impresso. Mais pessoas ainda estão imprimindo páginas da Web do que você imagina.
Adrian J. Moreno
2

Muitas vezes, acho que um post difícil leva tanto tempo porque requer pesquisa; essa pesquisa não apenas ajuda a sua postagem no blog, mas também ajuda a desenvolver seu próprio conhecimento pessoal no processo. Como você disse, você está reforçando o conhecimento escrevendo a postagem; você também está expandindo seu conhecimento. Abrace o tempo necessário e valorize-o como uma experiência de aprendizado.

Adrian
fonte
2

Sim, é normal que a redação técnica do blog leve tempo. Para mim, a escrita leva o menor tempo possível (de apenas uma hora ou até um dia, dependendo da duração). Em seguida, a edição e a reescrita geralmente levam mais tempo (até dois ou até três dias). Outro aspecto mencionado que leva tempo é o esclarecimento de qualquer código de exemplo. Além disso, gosto de gastar tempo procurando links de suporte para meus tópicos. Tudo leva tempo!

rickumali
fonte
0

Eu acho que você poderia escrever blogs técnicos agora, mas eu sugiro que você faça isso quando se tornar especialista em algum domínio específico. Passar um fim de semana não parece muito tempo. tudo depende da complexidade do tópico. Eu acho que o que estou dizendo é que o núcleo da sua ideia vem até você naturalmente. A execução pode (e vai) demorar mais.

As pessoas estão procurando conselhos de especialistas em um blog ... não experimentos noobs. mas estou falando de um modo geral. Não quero desencorajar você a escrever blogs. Mas lembre-se do seguinte.

1. Seu blog deve dizer algo novo. Não basta coletar dados e publicá-los em seu próprio blog

2. Tenha absoluta certeza do que você está dizendo, ou seja, mantenha-se com resultados empíricos fortes ou conceitos ou coisas altamente testados ou experimentados em primeira mão .

3. Esteja pronto para críticas.

4. Aprenda as técnicas de criação de blogs (precisão, concisão etc.)

5. Escreva algo porque você acha que deve ser escrito; não porque você acha que será lido.

Chani
fonte
4
"Eu sugiro que você faça isso quando se tornar especialista em algum domínio específico". Não concordo com esta afirmação. Ele pode ter um blog técnico onde ele tem postagens de coisas que ele aprendeu e queria compartilhar com todos os outros. Na verdade, eu estava pensando em fazer o mesmo tipo de coisa.
Jon
Sim, eu conheço alguém que publica uma quantidade incrível de coisas sobre as quais não tem a menor idéia. No entanto, esses posts são sobre como eles trabalharam aprendendo essas coisas ou como eles descobriram algo novo sobre alguma coisa.
Adrian J. Moreno
@jon @kungfu vocês dois devem escrever diários então! por que colocar outras pessoas em risco por causa de conselhos malsucedidos e não especializados? e quem você acha que iria ler essas coisas de qualquer maneira? (exceto para você talvez)
Chani
Se todo mundo pensasse isso, dificilmente haveria blogs. Até os blogs do MSDN têm postagens com base em suas experiências e em como as resolveram.
Jon
0

Os elementos do estilo

Eu acho que a escrita técnica segue muitas das mesmas regras que qualquer escrita. Se você ler apenas um livro sobre como escrever, deve ser o clássico Strunks "Os Elementos do Estilo" . Ele percorre uma lista de coisas que melhorarão sua composição, sendo o principal (IMO), "Omita palavras desnecessárias".

Eu também recomendaria " On Writing ", de Stephen King . Embora seja mais sobre a escrita fictícia, ele ainda contém muitas jóias para qualquer escritor aspirante, especialmente em áreas como edição e processo de escrita.

Dito isto, a parte mais difícil da redação técnica não é a redação real, mas o esclarecimento de seus pensamentos sobre a redação. O pensamento confuso leva a uma escrita ruim. Uma boa redação exige que você tenha uma noção clara do assunto, e é por isso que ensinar e escrever é uma excelente maneira de dominar um assunto.

Homde
fonte
0

Bem, levo muito tempo para escrever posts, sim. Costumo escrevê-los por vários dias, ou mesmo deixá-los em rascunho por algumas semanas, ocasionalmente os lendo novamente e corrigindo e ajustando um pouco aqui e ali.

Leva tempo, mas se esse é o preço para escrever algo do qual não tenho vergonha depois, acho que vale a pena.

jalf
fonte