Construção coletiva/Documentando seu projeto: diferenças entre revisões

[edição não verificada][edição não verificada]
Conteúdo apagado Conteúdo adicionado
Fazendo alguns ajustes/formatação
Linha 4:
== Primeiros Passos ==
 
* Cadastre-se no Wikilivros. Se você possui um cadastro em qualquer outro projeto da [[foundation:Wikimedia Foundation|Wikimedia Foundation]], como a Wikipédia, seu cadastro é válido para o Wikilivros.
* Após [[Especial:Entrar/signup|fazer seu cadastro]] acesse o livrowikilivro [[Construção coletiva]].
* Clique em editar, localizado no menu à cima.
* Adicione a página do seu projeto abaixo do último projeto adicionado, escrevendo assim:
'''<code><nowiki>:* [[/Nome do Seuseu Projetoprojeto/]]</nowiki></code>'''
* Pré visualize antesAntes de salvar, use o botão {{Botão|Mostrar alterações}} para pré visualizar sua edição e, se estiver tudo okcerto, grave suas alterações.
* Voltando para a página principal do livro [[Construção Coletivacoletiva]], seu projeto deverá aparecer em vermelho no índice, onde você o inseriu em vermelho. Clique nele e você já começará a editar um capítulo do livro, onde explicar de forma didática o seu projeto, de forma que os leitores possam utilizá-lo como referência em situações parecidas, ou quando precisarem usar ferramentas semelhantes.
* Veja algumas dicas de formatação logo abaixo.
 
== Utilizando linksligações externosexternas e referênciasnotas 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<ref>Veja mais informações na Wikipédia, consultando a página [[Wikipedia:Livro de estilo/Notas de rodapé]]</ref>.
Para utilizar links externos a melhor maneira é através de referências.
 
ParaAs criarnotas de rodapé fornecem uma forma de citar suas referências em wikis. O seu uso é fácil, bastabastando utilizar aum formatação: textocódigo <nowiki><ref>como httpeste://texto.com.br texto </ref> segue um exemplo.</nowiki>
Texto didático antes da nota de rodapé '''<nowiki><ref></nowiki>'''Conteúdo da nota de rodapé.'''<nowiki></ref></nowiki>'''. 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:
Se eu quiser colocar um link externo para o Twitter que eu abri para meu cliente, eu devo fazer o seguinte, "...Confira o Twitter do meu cliente Alex <nowiki><ref> hxxp://www.twitter.com/alexdunder Twitter do Alex Dunder Koch </ref></nowiki> para saber mais sobre ele...".
Segundo Alex Dunder Koch'''<nowiki><ref></nowiki>'''No <nowiki>[http://www.twitter.com/alexdunder Twitter do Alex]</nowiki> você pode encontrar mais informações sobre ele.'''<nowiki></ref></nowiki>''', as ferramentas web...
 
Agora veja qual seria o resultado de colocar o código acima em prática:
Agora veja na prática: <ref> http://www.twitter.com/alexdunder Twitter do Alex Dunder Koch </ref>
 
: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...''
Outro passo importante é criar uma área para todas suas referências na edição de seu projeto, a melhor maneira para isso é deixando essa formatação ao fim da sua edição:
 
Outro passo importante é criar uma área para todas suas referênciasnotas de rodapé na edição de seu projeto, a melhor maneira para isso é deixando essa formatação ao fim da sua edição:
<nowiki>== Referências ==</nowiki><br><nowiki><references/></nowiki>
<nowiki><references/></nowiki>
 
Assim, você terá um espaço no fim de sua documentação que agrupará todas suasas referências, (linksligações externos)externas e comentários que forem citadas ao longo do texto como notas de rodapé.
 
Veja um exemplo prático: no módulo [[Construção coletiva/Wits - Realizar e Bem Viver|Wits - Realizar e Bem Viver]].
[[Construção coletiva/Wits - Realizar e Bem Viver|Wits - Realizar e Bem Viver]]
 
== Utilize o Históricohistórico ==
 
EstáEstava editando sua documentação no WikibooksWikilivros 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.
Linha 39 ⟶ 43:
== Não se aproprie do conteúdo ==
 
Lembre-se que em um ambiente Wiki vocêé deveum serespaço colaborativo, então não assine suaum documentação,texto didático como se ele fosse "seu". Como visto acima, vocêos saberáleitores apodem ediçãosaber que você foi o usuárioautor realizoude peloum texto consultando o histórico da página. Assim, portantotodos ficam sabendo exatamente quais edições um colaborador realizou. Portanto, a assinatura em um Wikilivrowikilivro 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 idéiasideias 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 idéiasideias referentes à documentação no wikilivrosWikilivros? Então [[{{TALKPAGENAME}}|deixe seu comentário]] nesse tópico também.
 
== Referências ==