1. Este site usa cookies. Ao continuar a usar este site está a concordar com o nosso uso de cookies. Saber Mais.

Artigos/How-to's/Tutorials

Discussão em 'Programação' iniciada por NoMercy, 29 de Outubro de 2004. (Respostas: 1; Visualizações: 474)

  1. NoMercy

    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.
     
  2. NoMercy

    NoMercy Power Member

    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.
     

Partilhar esta Página