7/26/2019 Como Escrever Artigos Tcnicos (Melhores) Em 10 Passos _ Rafael Dohms

1/4

14/05/13 Como escrever artigos tcnicos (melhores) em 10 passos | Rafael Dohms

blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br 1/4

TweetarTweetar 1

Rafael Dohms

Web Engineer

Main menu

ProjectsResumeContactSite

Como escrever artigos tcnicos (melhores) em 10 passos

by Rafael Dohms September 27, 2011 Dicas e Truques, PH P, Tecnologia eInternet Comments (6)

Blogs. A internet nos ltimos anos tem visto o crescimento disparado destessites, desde o desenvolvedor que escreve no finais de semana at o colunista

que ganha para fazer isso. E no por menos, eles so sim uma tima ferramenta para divulgar seutrabalho e agregar valor ao seu nome no mercado, porm apenas se utilizado de forma correta. Voume restringir obviamente a falar de blogs sobre tecnologia e desenvolvimento, embora outras reastenham muitas historias de sucesso desta plataforma tambm. Eu realmente no saberia comocomentar por exemplo o mercado de esmaltes e como escrever artigos sobre eles.

Recentemente tenho esbarrado com alguns artigos que me deixam na dvida se seus autores

realmente entendem o que o papel de um blog e de artigos tcnicos, ou se o foco deles seriamenos honrado e apenas uma forma de atrair mais visitas. Sim, falo do que j conhecemos hoje nainternet como flame-baits ou seja, iscas para discusses (negativas). So geralmente postspolmicos, sem embasamento, movidos por uma opinio pessoal e carregados de termos clich epiadinhas. Menos mal se estes posts fossem apenas ferramentas de autores de blogs pessoais, muitopior quando aparecem em grandes veculos de comunicao ou sites especializados.

Dois exemplos me passaram pelo browser recentemente, um artigo gringo sobre PHP x Python, cujoembasamento completo era um tirinha XKCD, um pato e um pedao de cdigo ilegvel. O segundo,brazuca, intitulado PHPog, uma questo de design, publicado recentemente na iMasters. O grandecentro do artigo uma comparao entre PHP OO e Java OO, como as coisas deveriam ser feitas noPHP, e a grande reao dos leitores fo i a de que certas coisas no PHP so diferentes e isso no negativo (tem mais, mas vamos resumir assim). O questionamento vlido, e as discusses sobre aimplementao de OO do PHP tambm, porm o artigo vai alm disso, usando temos como o POG(programao orientada a gambiarras) para descrever a implementao e outras formas pejorativas

de tratar a linguagem e seus programadores.

Neste ponto mora o problema. Ao agredir a linguagem com piadinhas o resultado esperado pelopost no mais uma discusso sria sobre o assunto, e sim atrair milhares de fs sedentos porsangue para defender sua linguagem e retribuir palavras no carinhosas ao autor do artigo. Este foiexatamente o resultado de ambos artigos, sim eles tiveram muitas v isitas, sim tiveram muitoscomentrios, mas isso realmente bom? Compare 1000 visitas de xiitas revoltados com 200 visitasde pessoas querendo mostrar um ponto de vista diferente sobre um assunto, com qual vocaprender mais? E a imagem de sua empresa/sua pessoa, como ela vai ficar aps esse barulho todo?Pra mim os resultados de ambos artigos poderiam ser muito mais instrutivo, foco na discussestcnicas e menos barulho de extremistas e ativistas alm de exaltarem a imagem dos sitesenvolvidos por iniciarem discusses de alto nvel.

Por isso, uso este meu espao para ponderar sobre o assunto, e tentar mostrar minha opinio sobreo que seria um artigo tcnico bem escrito.

Como escrever artigos tcnicos melhores?

1. Evite usar tirinhas cmicas.Sim divertido, e vai quebrar o gelo, mas se voc precisaquebrar algum gelo, repense suas intenes com o artigo, elas podem j estar erradas.

2. Fuja de palavras polemicas e pejorativas. Evite usar termos como o POG citado acima, se oartigo fosse chamado Aplicando Design Patterns usando PHP: qual a melhor forma? a discussofinal teria se focado muito mais em discutir as implementaes de OO do PHP do que comentrioscomo Como se POG existisse s no PHP, ou < ?php print Calma galera ?> e at Nunca vi tantaignorncia incorporada em um nico texto.. Voc pode discordar da linguagem e de como algo foiimplementado, deve!, porm faa isso com o devido respeito e seriedade.

3. Expresse sua opinio, mas deixe isso claro. Cal Evans uma vez falou que um desenvolvedors pode ser considerado Snior, se o mesmo souber se expressar, ou seja, escrever artigos e mostrarseu trabalho e seu raciocnio atravs disso. Porm ele deve saber tambm defender suas ideias e

mais importante ainda, saber quando admitir o erro. Lembre-se disso, sempre haver opiniescontrrias, as vezes todas corretas em sua forma, mas as vezes voc realmente estar errado, saibaaceitar isso. Atualize o post se for o caso.

4. Pesquise. Estude. Pesquise. Escreva. Mesmo que sempre que voc for falar de um assunto oartigo no passe de sua interpretao sobre o mesmo, sempre uma boa ideia se precaver. Portantopesquise muito sobre o assunto, procure opinies contrrias e analise de outros pontos de v ista.

http://blog.doh.ms/category/tecnologia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#idc-containerhttp://blog.doh.ms/category/tecnologia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/tecnologia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-brhttp://www.rafaeldohms.com.br/http://www.rafaeldohms.com.br/resume/http://blog.doh.ms/?lang=pt-br/http://imasters.com.br/artigo/21865/php/phpog-uma-questao-de-designhttp://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#idc-containerhttp://blog.doh.ms/category/tecnologia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/desenvolvimento-dev/php-desenvolvimento-2/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/desenvolvimento-dev/dicas-desenvolvimento-2/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/author/admin/http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-brhttp://www.rafaeldohms.com.br/http://blog.doh.ms/contact/http://www.rafaeldohms.com.br/resume/http://www.rafaeldohms.com.br/project/http://blog.doh.ms/?lang=pt-br/http://twitter.com/search?q=http%3A%2F%2Fblog.doh.ms%2F2011%2F09%2F27%2Fcomo-escrever-artigos-tecnicos-melhores-em-10-passos%2F%3Flang%3Dpt-brhttps://twitter.com/intent/tweet?original_referer=http%3A%2F%2Fblog.doh.ms%2F2011%2F09%2F27%2Fcomo-escrever-artigos-tecnicos-melhores-em-10-passos%2F%3Flang%3Dpt-br&text=Como%20escrever%20artigos%20t%C3%A9cnicos%20(melhores)%20em%2010%20passos&tw_p=tweetbutton&url=http%3A%2F%2Fblog.doh.ms%2F2011%2F09%2F27%2Fcomo-escrever-artigos-tecnicos-melhores-em-10-passos%2F%3Flang%3Dpt-br&via=rdohms

7/26/2019 Como Escrever Artigos Tcnicos (Melhores) Em 10 Passos _ Rafael Dohms

2/4

14/05/13 Como escrever artigos tcnicos (melhores) em 10 passos | Rafael Dohms

blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br 2/4

Share this:

Login

@brunoviana +2

ReportReply

Domingos Teruel +2

ReportReply

Caso esteja aberto a admitir o erro depois lembre-se das regras acima, elas iro potencializar umaresposta positiva e o aprendizado.

5. Referncias == credibilidade. Se o que voc quer explicar se baseia em algum material que leu,faa sempre referncias ao material, aponte de onde ele veio, isso trar para o seu contedo maisrelevncia e agregar os argumentos do outro autor aos seus.

6. Quantidade no significa Qualidade.Ter 1001 visitas no significa que seu artigo bom, ouruim. Artigos polmicos, ou sem embasamento e agressivos acabam atraindo muitas visitas, pessoasque querem ver pra acreditar, ou deixar um comentrio agressivo. Se o seu objetivo ter muitasvisitas isso realmente funciona, porm qual foi a impresso que as pessoas tiveram de voc ao sairde l? Agora um artigo que deveria divulgar seu trabalho e te projetar como profissional, acabou de

mudar a opinio de pessoas para no mais te considerar para uma possvel vaga.

7. No critique, compare. Respeite. Muitas vezes vejo artigos escritos apenas para debochar ouridicularizar algo, ou a forma como algum fez algo. Quer fazer algo construtivo? Faa umacomparao sobre como o artigo foi escrito e como ele poderia ser escrito, talvez at de umas dicasde como melhorar. Alm de tudo, respeite o profissional que escreveu ou criou aquilo que alvo deseu artigo, nem todos concordamos em tudo, mas isso no motivo para chacota e desrespeito.

8. Exemplos prticos.Nem todo tema passvel de um exemplo prtico, mas em se falar detecnologia e desenvolvimento isso geralmente possvel, ento faa! Anexe um cdigo, aponte umrepositrio, um diagrama de classes ou um ERM. Ilustre seu artigo com exemplos e grficos, a leiturafica mais agradvel e coerente.

9. Comeo, meio e fim.Pense e planeje seu artigo. Todo artigo tem um objetivo. Para chegar neleo artigo precisa de um comeo ou uma introduo, um meio ou o desenvolvimento do tema, e umfim, a concluso. Isso se aplica a todos artigos, mas tambm vale pra artigos tcnicos. Por exemplo:

Descreva o problema que vai resolver, mostre como resolver e conclua se foi ou no uma boaescolha. Garanto que se o seu artigo passa 5 pargrafos contanto a historia do John Armless e nofinal no explica onde ele se encaixa no tema nem porque, seus leitores vo ficar confusos, eindignados.

10. Dont be a douchebag. Eu gosto desta frase em ingls por ela ser a forma mais ofensiva semser ofensiva de se dizer, no seja um chato. Acalme o ego, baixe a crista, seja srio e respeitoso,receba comentrios bem, mesmo os mal educados.

Bem, seguindo minha prpria receita, esta minha opinio, assim so construdos os artigos que eurespeito e gosto de comentar e discutir. Posso estar errado, ento por favor comente sua viso doassunto nos comentrios, faltou alguma regra? Espero que este artigo possa inspirar artigosmelhores de valor tcnico e que discusses possam brotar destes.

Tags: dicas, escrevendo artigos, PHP

A b o u t Rafae l D ohms

Rafael Dohms is an experienced PHP Developer, Evangelist, Speaker and Contributor. During hisyears of experience he has become an active member of the community and founded 3 User Groups.He moved to the Netherlands to integrate the WEBclusive team and share his passion for codequality and innovation in the Crowd funding world. In his spare time he also helps manage theAmsterdamPHP User Group, amongst other projects.

http://doh.ms

Comments (6)Sort by: Date Rating Last Activity

83 weeks ago

Eu s digo uma coisa: quem AINDA no sculo XXI discute sobre linguagens e debate qual melhorque a outra ainda precisa caminhar um bucado pra ser um desenvolvedor de verdade.

2 replies active 34 weeks ago

80 weeks ago

Concordo contigo. Somos engenheiros de software nossa unica funo resolver os problemasda melhor forma e com a melhor ferramenta para aquele problema.

Dhoms, excelente artigo cara.

http://intensedebate.com/postRSS/108245750http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment212629267http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment203106493http://doh.ms/http://blog.doh.ms/author/admin/http://blog.doh.ms/tag/php/http://blog.doh.ms/tag/escrevendo-artigos/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/dicas/https://www.facebook.com/mingomaxhttp://%20showreply%28212629267%29/http://%20showreportbox%28212629267%29/http://%20votecomment%28212629267%2C%200%29/http://%20votecomment%28212629267%2C%201%29/https://www.facebook.com/mingomaxhttp://twitter.com/brunovianahttp://%20showreply%28203106493%29/http://%20showreportbox%28203106493%29/http://%20votecomment%28203106493%2C%200%29/http://%20votecomment%28203106493%2C%201%29/http://twitter.com/brunovianahttp://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br&share=linkedin&nb=1http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br&share=google-plus-1&nb=1http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br&share=twitter&nb=1http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br&share=facebook&nb=1

7/26/2019 Como Escrever Artigos Tcnicos (Melhores) Em 10 Passos _ Rafael Dohms

3/4

14/05/13 Como escrever artigos tcnicos (melhores) em 10 passos | Rafael Dohms

blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br 3/4

Hudson 0

ReportReply

diogo 0

ReportReply

diogo 0

ReportReply

Antfermar 1p +1

ReportReply

Enter text right here!

Name Email ebsite (optional)

Comment as a Guest, or login:

Displ aye d ne xt to your comme nts. N ot displ aye d publ icl y. If you ha ve a we bsi te , l ink to it he re .

Submit Comment

34 weeks ago

Concordo plenamente, como um amigo meu diz: "A melhor linguagem aquela que vocdomina.".

timo post, continue assim.

44 weeks ago

que excelente post

grande informaaoabrao

44 weeks ago

que excelente postmuito obrigado amigogrande abrao

74 weeks ago

Shows Rafael gostei muito do seu artigo, to fazendo um blog para mim, estava j com essa ideia,

depois que voc falou ainda no PHP CONFERENCE 2011 ai tive mais animo para fazer esse blogcreio que at janeiro j coloco na rede em 2 idiomas Ingls e Portugus __boa sorte ai abrao.

Post a new comment

Subscribe to one

Sobre/About

Rafael Machado Dohmsis a webdeveloper and PHP Evangelist, find outmore here.

Feeds

English FeedFeed em Portugues

Categories

Anlises(1)Carreira(1)Desenvolvimento(7)

Dicas e Truques(2)

PHP(5)Eventos(1)Pessoal/Off-topic(8)Tecnologia e Internet(2)

Empresas(1)

facebook

Portugus

http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#http://creativecommons.org/licenses/by-nc-sa/3.0/http://blog.doh.ms/category/tecnologia/empresas/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/tecnologia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/pessoaloff-topic-pt-br/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/eventos-2/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/desenvolvimento-dev/php-desenvolvimento-2/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/desenvolvimento-dev/dicas-desenvolvimento-2/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/desenvolvimento-dev/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/carreira/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/category/analises/?lang=pt-br&lang=pt-brhttp://feeds.feedburner.com/RafaelDohmshttp://feeds.feedburner.com/RafaelDohms/enhttp://zend.com/zce.php?c=ZEND006646&r=227171123http://zend.com/zce.php?c=ZEND006646&r=227171123http://doh.ms/http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment236641127http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment396030151http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment396030404http://blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br#IDComment439568900http://%20showreply%28236641127%29/http://%20showreportbox%28236641127%29/http://www.afminfor.com/bloghttp://%20votecomment%28236641127%2C%200%29/http://%20votecomment%28236641127%2C%201%29/http://www.afminfor.com/bloghttp://%20showreply%28396030151%29/http://%20showreportbox%28396030151%29/http://melhordobrasil.net/http://%20votecomment%28396030151%2C%200%29/http://%20votecomment%28396030151%2C%201%29/http://melhordobrasil.net/http://%20showreply%28396030404%29/http://%20showreportbox%28396030404%29/http://melhordobrasil.net/http://%20votecomment%28396030404%2C%200%29/http://%20votecomment%28396030404%2C%201%29/http://melhordobrasil.net/http://%20showreply%28439568900%29/http://%20showreportbox%28439568900%29/http://%20votecomment%28439568900%2C%200%29/http://%20votecomment%28439568900%2C%201%29/

7/26/2019 Como Escrever Artigos Tcnicos (Melhores) Em 10 Passos _ Rafael Dohms

4/4

14/05/13 Como escrever artigos tcnicos (melhores) em 10 passos | Rafael Dohms

blog.doh.ms/2011/09/27/como-escrever-artigos-tecnicos-melhores-em-10-passos/?lang=pt-br 4/4

by 1,216readers1,472comments

IntenseDebate

Archives

elect Month

Calendar

September 2011

S M T W T F S

Aug Nov

1 2 3

4 5 6 7 8 9 1011 12 13 14 15 16 17

18 19 20 21 22 23 24

25 26 27 28 29 30

Tags

ambienteamsterdamcomunidadecontributecparty2011cpbr4erros da midiaescrevendo artigosferramentasgithubmudanasdkseguranatipstrilhando o caminho php 2013 Rafael Dohms. All Rights Reserved. Created using PressWork.

WordPress multi-idiomapor ICanLocalize

http://www.icanlocalize.com/site/http://wpml.org/http://presswork.me/http://blog.doh.ms/?lang=pt-brhttp://blog.doh.ms/tag/trilhando-o-caminho-php/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/tips/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/seguranca/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/sdk/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/mudanca/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/github/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/ferramentas/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/escrevendo-artigos/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/erros-da-midia/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/cpbr4/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/cparty2011/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/contribute/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/comunidade/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/amsterdam/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/tag/ambiente/?lang=pt-br&lang=pt-brhttp://blog.doh.ms/2011/09/27/?lang=pt-brhttp://blog.doh.ms/2011/11/?lang=pt-brhttp://blog.doh.ms/2011/08/?lang=pt-brhttp://www.intensedebate.com/