Redação técnica na era da IA

Isso não surgiu do nada:

Essas são pessoas que admiro profundamente e estaria mentindo se dissesse que discordo de alguma dessas coisas. O fato é que a demanda por redação técnica de front-end caiu significativamente, e já existe há algum tempo . Basta olhar nossas estatísticas:

Não tenho vergonha de compartilhar isso porque está acontecendo em todos os níveis. Quero dizer, é a mesma coisa no Stack Overflow que já discutimos em profundidade . Trabalho com outros criadores de conteúdo e publicações e é a mesma história.

Naturalmente, tendo a assumir responsabilidade pessoal por esse tipo de coisa, mas é difícil não ver que a causa raiz pode estar fora do meu controle:

E sim, estou apontando diretamente para a IA. É um pouco injusto dizer que não existem outros fatores que impactem nosso trabalho e este site especificamente, mas vamos chamar as coisas pelos seus nomes e identificar os maiores ventos contrários.

Não se trata totalmente de IA. Trata-se de redação técnica na era da IA. Tenho algumas ideias sobre isso e espero que seja útil para a leitura de vocês, humanos.

Ainda precisamos de redação técnica

Os bots certamente não estão aprendendo coisas novas por conta própria, certo? Eles ficam tão motivados quanto a indicação que recebem, e é o desejo e o esforço humanos que fazem as coisas avançarem.

Quero reconhecer imediatamente que não estou sugerindo que a IA seja o novo público principal para redação técnica. São pessoas reais como você, com motivação para aprender, que mantêm essa prática viva, mesmo que seu aprendizado se torne os prompts que permitem que a IA gere código para você.

Encontrando seu lugar

Para quem (ou para quê) você está escrevendo? Pode ser que a sua posição na criação de conteúdo técnico precise de uma mudança. Por exemplo, aposto que criar documentação técnica é menos valioso do que antes. Não só temos muito disso nas especificações e no MDN, mas esses tipos de perguntas dos desenvolvedores agora estão sendo respondidas diretamente em um bate-papo incorporado diretamente no IDE.

“Mas CSS-Tricks está cheio de tudo isso!” você pode dizer. E é verdade. Temos um Almanaque de bondade do CSS que cresceu, evoluiu e tem sido cuidado desde, acredito, 2009. Nós até o expandimos apenas alguns anos atrás. Isso porque acho que CSS-Tricks tem um lugar claro na era da IA…

…e isso torna a documentação técnica mais acessível aos humanos. Você leu as especificações ? Eles são densos e projetados para oferecer precisão e clareza para navegadores que implementam recursos CSS. São explicações muito técnicas para tópicos muito técnicos. Gosto de pensar que CSS-Tricks é aquele lugar que você procura para obter explicações humanas para tópicos muito técnicos – mais como sentar à mesa com outro desenvolvedor tomando café (ou kombuchá, o que for). Servimos o mesmo tipo de propósito, mas fazemos disso uma experiência única. É tudo uma questão de diminuir as barreiras de acesso ao por aqui!

Mas também queremos ser uma plataforma para grandes ideias. Este site costumava ser um espaço de aprendizagem pessoal para Chris Coyier quando ele o iniciou em 2007. Mas isso mudou completamente quando Chris abriu as coisas para autores convidados. Foi assim que comecei aqui em 2015. # E trouxemos 748 autores (enquanto escrevo isto) desde então. Pense em todas as ótimas ideias, dicas – e sim – truques que surgiram e que podemos ter perdido sem um palanque de CSS-Tricks para compartilhá-los. Eu literalmente aprendi tudo o que sei sobre front-end com essas pessoas.

Ainda vale a pena?

Só você pode responder isso. É sobre dinheiro? É uma questão de popularidade? É sobre artesanato? É uma questão de aprendizagem pessoal? Alguma combinação de coisas? Não estou aqui para dizer que nenhum deles é melhor que os outros, mas definitivamente há um motivo pelo qual você decidiria continuar escrevendo peças técnicas (ou qualquer tipo de escrita, na verdade) nesta época.

Acho que já argumentei por que faço isso. Mas você ainda pode pensar que não vale a pena fazer isso, mesmo que acredite que tem um propósito nisso. Talvez seja insustentável manter um blog ou boletim informativo financeiramente nesta escala. Talvez outras coisas estejam competindo pelo seu tempo. Talvez um novo emprego realmente excelente seja mais atraente.

Ou talvez você esteja simplesmente esgotado. Você viu os comentários no início disso. O tempo, o esforço e as expectativas de um trabalho como este são altíssimos e a recompensa – seja qual for a medida – pode não ser suficiente. Se for esse o caso, o resultado é apatia e esgotamento. Eu certamente sinto isso e admito que alguns dias não são tão bons quanto outros.

Mas ainda acho que o I/CSS-Tricks tem um lugar para preencher. E ainda há muita realização pessoal sempre que um comentário em um artigo, um e-mail ou uma menção social nos diz que nosso trabalho está ajudando de alguma forma. Realmente. E eu sugiro que seus redatores técnicos favoritos saibam que você gosta e confia no trabalho deles, onde quer que os esteja lendo.

É uma espécie de balanço de pêndulo

Não, não, não. Não vejo um futuro onde a IA se desintegre repentinamente e estejamos escrevendo código inteiramente à mão novamente.

O que quero dizer é que a redação técnica – e o web design criativo como um todo – já existiram antes. Compartilhar o que aprendemos à medida que criamos coisas novas e interessantes já foi totalmente contra a corrente, certo? Adoro como Jay Hoffman documentou isso em nossos Arquivos de histórico :

Os artigos que apareceram no  Word  eram únicos, onde as imagens, fundos e cores escolhidas ajudavam a facilitar o tom de uma peça. Essas postagens com direção de arte foram inspiradas no estilo característico de Levy, uma mistura de gráficos de 8 bits e layouts desequilibrados, com a bricolagem caótica dos zines de punk rock. As páginas ganharam vida, representando através do design a personalidade do autor do post.

O web design era muito punk rock nos anos 90 e início dos anos 2000. Depois virou uma disciplina. Agora está se tornando automatizado. E, como tal, o web design humano é punk rock mais uma vez. Ou pelo menos pode ser .

Novos conselhos para redação técnica

Publicamos um artigo abrangente com conselhos de redação técnica em 2019 . Eu não acho que subtrairia ou mudaria nada disso. Tudo o que está ali ainda é tão relevante e verdadeiro hoje como era naquela época. O objetivo é escrever sobre um tópico oportuno para um público específico da maneira mais clara possível e que inclua diferentes estilos de aprendizagem.

Mas acho que acrescentaria algo a essa peça à medida que a paisagem continua a mudar. Meu conselho?

Hum, talvez não use IA

Por um lado, sabemos que nem sempre é preciso . Dois, dilui sua voz pessoal . Ambos são muito prejudiciais para a disciplina da escrita. E qual é o sentido de dar às pessoas uma explicação de IA sobre algo que elas já podem obter com muito mais facilidade em seu IDE? Isso é exatamente o que leva ao desperdício de IA.

Mas não vou descartar o uso de IA no atacado. Na verdade, vou ressalvar toda a coisa de “não usar IA” para fixá-la especificamente na escrita. Porque uma ferramenta como Grammarly sempre foi útil, mesmo antes de ser comercializada como um conjunto completo de escrita de IA. Você não precisa usar os recursos mais robustos que praticamente fazem a escrita para você aproveitar algo.

Costumo recorrer à IA para ajudar em tarefas simples: verificações ortográficas rápidas, conversão de Markdown em HTML, manutenção do calendário de publicação dentro do cronograma, coisas assim. A IA é muito boa com trabalhos de baixa elevação que não têm muito ou nada a ver com escrita.

(Eu também diria que muito do que chamamos de “IA” hoje é o que chamávamos de “automação” antes do hype. Estou mais interessado nas ferramentas que ajudam a aprimorar nosso trabalho, não em substituí-lo.)

Mais experiências da vida real, menos documentação

Se você for escrever sobre algo, eu me concentraria no que a IA não consegue resolver sozinha, ou pelo menos não consegue resolver facilmente. Já é muito bom fornecer a definição básica de qualquer propriedade CSS junto com um exemplo de código rápido, geralmente extraído diretamente da documentação técnica existente. Esse é um território bem trilhado, a menos que você o embale de uma maneira diferente.

Aprendo melhor quando me deparo com um desafio, como algo que um cliente deseja e que nunca tentei antes. Aposto todo o meu bolso que é assim que você aprende melhor também. Cometemos erros e aprendemos com eles. E para escritores técnicos, é o caminho do novato ao entendimento que faz toda a diferença. Esse é o gancho. Isso dá aos seus leitores um modelo mental para usar em seu próprio trabalho – novamente, mesmo que esse modelo mental vá direto para a escrita de prompts de IA.

Então, novamente, sou o produto da geração View Source . Da mesma forma que muitos músicos aprenderiam desacelerando um toca-discos para aprender acordes, notas ou batidas. Talvez eu seja o velho gritando para as nuvens.

Você não precisa ser a autoridade

Eu sei que há pelo menos uma pequena expectativa de que tudo o que publicamos em sites como CSS-Tricks seja a maneira “certa” de fazer isso ou aquilo e que você deve ser capaz de copiar e colar trechos de código diretamente. Eu entendo isso, mas também não acredito que seja uma promessa que este site já fez. Eu realmente acredito que CSS é poético no sentido de que há mais de uma maneira de fazer algo, e a melhor maneira de fazer isso é aquela que se adapta melhor ao seu modelo mental.

E acredito que há um valor real em tentar algo apenas por tentar .

Este site sempre foi voltado para explorar, experimentar e compartilhar ao longo do caminho. E às vezes isso significa compartilhar apenas o germe de uma ideia. Não há dogma aqui.

O objetivo: ser experiente, não cínico. Você não precisa ser a autoridade máxima em um assunto para ter permissão para compartilhar. Apenas experiência, e isso nem sempre é o mesmo que ser especialista.

Tudo isso realmente para dizer:

Aprenda rápido, compartilhe com frequência

O que você aprender será mais significativo para uma pessoa real do que alguma substituição gerada da resposta do Stack Overflow.

• Você tentou alguma coisa e não deu certo?
• Você tentou algo e deu certo?
• Você cometeu vários erros no caminho para acertar?
• Você ainda tem dúvidas sobre o que aprendeu?

Vale a pena compartilhar tudo isso. É daí que vêm as experiências da vida real e os caminhos de aprendizagem que você simplesmente não obtém com as respostas geradas que afirmam ter a melhor resposta.

Dito de outra forma: resolva problemas reais. Entre nos casos extremos. Aproveite o conhecimento da comunidade.

Cite generosamente

No final das contas, tudo se resume a humanos ajudando humanos. Não acordamos um dia com todas as respostas. Aprendemos com as coisas que outras pessoas aprendem e compartilham, e vale a pena orientar seus leitores na direção delas. É fácil querer parecer a fonte original de tudo o que você publica, mas minha experiência é que isso nunca é verdade.

Nós construímos um ao outro. Basicamente, o blog é. Vamos construir uns aos outros da boa e velha maneira com hiperlinks .

Esqueça SEO… ou mesmo AIO

Nós mergulhamos no SEO vários anos atrás, mas nunca foi realmente nosso problema. Nós viajamos e aproveitamos o Trem da Pesquisa Orgânica desde sempre. Isso é libertador porque nunca nos preocupamos com excesso de palavras-chave, títulos que induzem cliques ou qualquer coisa realmente otimização nesse caso. Em vez disso, nos concentramos em escrever para humanos, com boa estrutura e em manter uma certa voz e tom. Todas as coisas com as quais o Google costumava se preocupar.

Eu digo “costumava me importar” porque esse valor central contém menos valor do que nunca , mesmo que eles ainda afirmem que sim .

Não há dúvida sobre isso; o tráfego de pesquisa é eliminado em favor das respostas geradas a consultas relacionadas aos serviços que você usa. Isso é um claro impacto no tráfego e nas formas tradicionais de gerar receita que são medidas pela análise de tráfego.

E esqueça o que quer que seja chamado de “Otimização de Inteligência Artificial” ( AIO ). Ainda é um espaço em evolução de “melhores” práticas fluidas e inconsistentes, como alguns agentes interessados ​​em propostas para arquivos baseados em texto para ajudar LLMs a usar seu site que outros agentes, como o Google, simplesmente não gostam . Talvez se torne uma disciplina com estratégias, diretrizes e melhores práticas mais claras no futuro, mas simplesmente não sabemos e estou fingindo ignorância, pelo menos até a fumaça baixar.

Sinceramente, não tenho certeza se me importo com o fato de os truques CSS aparecerem como referência em uma resposta gerada. A paisagem está evoluindo e meus pensamentos sobre ela também devem evoluir.

Você consegue.

Estou torcendo por você. Estou torcendo por todos nós.

Redação técnica na era da IA ​​ originalmente escrita à mão e publicada com amor em CSS-Tricks . Você realmente deveria receber o boletim informativo também.