Artigos/How-to's/Tutorials

NoMercy

Power Member
Esta thread server para incentivar e definir alguma linhas de orientação (guidelines) para a escrita (e post aqui no forum) de Artigos/How-to's/Tutorials sobre programação.
O próximo post terá a definição destas "linhas de orientação". As linhas de orientação servem para arranjar-mos uma forma de organização e standartização da forma como expomos informação. A forma como expomos informação determina o sucesso/insucesso da compreensão da informação que pretendemos transmitir. Estas linhas de orientação não são completamente fixas e podem e serão provavelmente, melhoradas consoante a necessidade.
Tendo dito isto queria responder ás seguintes perguntas (que por esta altura já devem estar a fazer a vós próprios ;) ):

-Porquê escrever artigos?
Bom, existem muitas razões:
A nossa partilha de informação gera partilha de informação de terceiros
Quando escrevemos artigos, não só ajudamos terceiros a aprender, como também nós próprios aprendemos de diversas formas. Muitas vezes enquanto escrevemos um artigo, acabamos por nos deparar, e consecutivamente aprender, com coisas que anteriormente não tínhamos reparado, quer seja porque o resultado não era o que esperávamos quer pela crítica dos leitores quando estes corrigirem, apresentarem alternativas e extenderem o que acabamos de criar. Alem do mais, a escrever, acabamos por melhorar o nosso Português escrito. É claro que nem todos somos nem podemos nem queremos ser Camões, Eça de Queiroz e por ai adiante, mas, melhorar a nossa escrita e a sua compreensão, ajuda-nos a melhorar o processo de comunicação.
(não que eu escreva lá muito bem, mas, vou tentando ;))
Outra razão, é que estão a contribuir para o interesse e validade deste fórum de programação.

Seguem então, no próximo post as linhas de orientação gerais.
 
Guidelines para postarem artigos/how-to's/tutorials

Para já, quando postarem artigos, vou deixá-los em sticky, mais tarde se os sticky's começarem a ocupar muito espaço arranjamos outra forma de organizar.
Escrevam o titulo do post aqui no forum mais ou menos assim:

[artigo ou how-to ou tutorial] linguagem - pequena descrição

Para já, quando postarem artigos, vou deixá-los em sticky, mais tarde se os sticky's começarem a ocupar muito espaço arranjamos outra forma de organizar.

-Temática:
Qualquer coisa relacionada com programação.
Pode ser sobre uma linguagem, plataforma, técnologia, ambiente/"ferramenta" de desenvolvimento.
Artigos estilo "A" vs "B" com testes, comparações, resultados, opiniões pessoais, e conclusões. Quanto melhor forem os dados apresentados para justificar as conclusões ... melhor.

-Cabecalho:
Devem ter um cabeçalho a indicar as seguintes informações:
-Classificação:
Devem ter os seguintes atributos de classificação:
- Técnologia/Plataforma.
- Linguagem programação (no caso de ser usada uma).
- Nível (classificado nos seguintes níveis de dificuldade: Beginner, Intermediate e Advanced.
- Assunto.
- Pré-requesitos.

-Versão:
A versão do documento composto da seguinte forma x1.x2 em que x1 é uma versão nova e x2 é uma revisão. As versões começam e 1 e as revisões em 0.

-Log de alterações:
Pequeno resumo das alterações no caso de se estar a fazer alterações a uma artigo anteriormente publicado.
No caso da ser a primeira versão não é necessário.

-Autor:
Nome.
Informações adicionais sobre o autor (se o autor o desejar fazer).


Podem, para já, tomar esta thread http://www.techzonept.com/showthread.php?t=45283 como exemplo se quiserem.
 
Back
Topo