Construção coletiva/Documentando seu projeto

Esse capítulo tem como objetivo fornecer dicas e ajuda com a formatação utilizada nesse livro, que serve para os Agentes TEIA documentarem seus projetos e aprenderem mais sobre este ambiente e sobre o que pode ser feito para desenvolver seus trabalhos através da construção coletiva.

:* [[/Comunidade Virtual de Escolas Aprendentes/]]

Utilizando ligações externas e notas de rodapé

Para incluir ligações externas ao longo de uma explicação, uma boa opção é o uso de notas de rodapé como esta.

As notas de rodapé fornecem uma forma de citar suas referências em wikis. O seu uso é fácil, bastando utilizar um código como este:

Texto didático antes da nota de rodapé <ref>Conteúdo da nota de rodapé.</ref>. Continuação das explicações.

Por exemplo, se alguém quiser colocar uma ligação externa que aponte para uma página do Twitter, poderá fazer o seguinte:

Segundo Alex Dunder Koch<ref>No [http://www.twitter.com/alexdunder Twitter do Alex] você pode encontrar mais informações sobre ele.</ref>, as ferramentas web...

Agora veja qual seria o resultado de colocar o código acima em prática:

Segundo Alex Dunder Koch, as ferramentas web...

Outro passo importante é criar uma área para todas suas notas de rodapé na edição de seu projeto, a melhor maneira para isso é deixando essa formatação ao fim da sua edição:

== Referências ==
<references/>

Assim, você terá um espaço no fim de sua documentação que agrupará todas as referências, ligações externas e comentários que forem citadas ao longo do texto como notas de rodapé.

Veja um exemplo prático no módulo Wits - Realizar e Bem Viver.

Inserindo imagens

Para inserir a imagem de seu projeto, como o screenshot de uma rede no Ning, primeiro hospede a imagem no Wikilivros e escolha a linceça adequada para ela. Depois de hospedar a imagem, vá para a edição de seu projeto e insira o código de thumbnail, como no exemplo abaixo:

[[Ficheiro:Nome da imagem hospedada no Wikilivros.jpg|250px|thumb|right| Legenda da imagem]]

O Ficheiro é o nome da imagem hospedada juntamente com a extensão da mesma, como .jpg, .gif, etc. 250px é o tamanho que a imagem ficará, right é a disposição da imagem, no caso à direita, você também pode utilizar outra disposição, como left para a imagem ficar na esquerda e a legenda é o texto da imagem, procure utilizar um texto que explique o que é a imagem, como por exemplo o nome da rede que você criou.

Utilize o histórico

Estava editando no Wikilivros e salvou alguma coisa errada sem querer? Não se desespere, utilize o histórico que fica localizado no menu de cima, ao lado do editar.

Ao clicar no histórico, você verá todas as edições passadas e qual o usuário responsável pela edição. Você pode visualizar as edições passadas e até mesmo desfazer edições, para o caso de você ter salvo algo por engano.

Não se aproprie do conteúdo

Lembre-se que em um ambiente Wiki é um espaço colaborativo, então não assine um texto didático como se ele fosse "seu". Como visto acima, os leitores podem saber que você foi o autor de um texto consultando o histórico da página. Assim, todos ficam sabendo exatamente quais edições um colaborador realizou. Portanto, a assinatura em um wikilivro como este não é recomendada.

Não utilize um linguajar proprietário, você não pode se apropriar do capítulo que você está escrevendo, afinal, ele está aberto para edições e sugestões de diversos outros usuários.

Abra sempre um espaço para dicas, sugestões ou ideias para sua documentação e seus projetos, assim qualquer pessoa no Wikilivros poderá lhe ajudar a desenvolver seus projetos na web através da Construção Coletiva.

Você tem mais dicas, informações, dúvidas ou ideias referentes à documentação no Wikilivros? Então deixe seu comentário nesse tópico também.