Manual Para Colaboradores: Difference between revisions

From MoodleDocs
No edit summary
 
No edit summary
 
(One intermediate revision by the same user not shown)
Line 36: Line 36:


[[en:MoodleDocs:Guidelines_for_contributors]]
[[en:MoodleDocs:Guidelines_for_contributors]]
[[pt:MoodleDocs:Manual_para_Colaboradores]]
[[pt_br:MoodleDocs:Manual_Para_Colaboradores]]

Latest revision as of 17:12, 16 January 2008

Template:Ajuda

Introdução

  • A sua contribuição para o Moodle Docs será sempre bem-vinda. Pode ajudar melhorando algo já existente, em termos de conteúdo, gramática ou formatação!
  • Se ainda não o fez, por favor autentique-se.
  • Tenha em conta que qualquer contribuição será publicada sob os termos da Licença Pública Geral GNU.
  • A partir da versão 1.6, todas as páginas num sítio Moodle contêm um apontador para a página correspondente no Moodle Docs. Poderá ver um exemplo em moodle.org e, a visão de um administrador, no Sítio de demonstração do Moodle.
  • É de salientar que os ficheiros de ajuda do Moodle permanecerão inseridos em cada pacote linguístico e, por tanto, não é preciso incluí-los neste sítio.
  • A ilustração da documentação com imagens do ecrã é muito bem-vinda. Para mais informações, consulte o guia de estilo.
  • Se encontrar alguma página que deva ser apagada, por favor escreva o texto {{Deletion}} no topo dessa página.

Criação de novas páginas

  • Pode criar páginas adicionais para a documentação. Agradecemos especialmente a criação de páginas em falta, que já existam na versão em inglês do Moodle Docs e que não existem neste sítio. Simplesmente escreva o nome da nova página entre parêntesis rectos duplos, [[Nome da página]], numa página já existente que deva apontar para a nova página, grave a sua alteração, e clique sobre o apontador que deverá aparecer, para começar a editar a página. Alternativamente, pode escrever na linha de endereços do seu browser: https://docs.moodle.org/pt/Nome_da_página (repare que os espaços foram substituidos por _).
  • Se estiver a traduzir uma página do Wiki em inglês, por favor traduza o nome para o português. Escolha um nome curto e use maiúsculas unicamente na primeira letra (salvo excepções, como nomes próprios, por exemplo, Moodle).
  • As páginas de documentação para programadores deverão ser inseridas dentro do espaço de nomes Programador; nomeadamente, o nome deverá ser precedido por Programador:; por exemplo, [[Programador:Nome da página]].
  • Por favor leia e aplique o guia de estilo. Em particular, verifique que as novas páginas sejam incluidas em alguma categoria.
  • Os nomes das páginas poderão ser alterados nos futuro, usando redireccionamentos, quando alguma restruturação da documentação assim o sugerir.

Ligação entre diferentes línguas

  • Pode inserir ligações entre páginas dos sítios das diferentes línguas, para que os utilizadores possam ver o texto em outras línguas. Bastará escrever no fim da página, por exemplo, [[en:Nome da página em inglês]] para apontar para a versão em inglês, e no Wiki em inglês pode escrever, no fim da página, [[pt:Nome da página em português]] para que os visitantes do Wiki em inglês possam ver a versão em português. Os apontadores para páginas em outras línguas aparecerão automaticamente no bloco "Outras línguas".


Predefinições para as versões do Moodle

  • Quando adicionar documentanção para alguma funcionalidade nova, por favor inclua no início uma Predefinição para a versão do Moodle em que essa funcionalidade apareceu. Por exemplo, {{Moodle 1.8}}.
  • Para além de salientar diferenças entre as versões do Moodle, as predefinições classificam automaticamente a página numa categoria correspondente à versão do Moodle. No exemplo acima seria: Categoria:Moodle 1.8.
  • As predefinições para versões do Moodle que já não estejam disponíveis em Moodle downloads podem ser eliminadas e substituidas com algum texto simples, por exemplo, "A partir de Moodle 1.5 ...".

Comentários sobre as páginas

  • Se quiser comentar sobre alguma página já existente, por favor use a área de comentários dessa página (clique no separador de comentários no topo da página). Por favor assine e escreva a data nos seus comentários, bastando escrever quatro tils no fim: ~~~~ (o Wiki substituirá esses caracteres pelo seu nome e data).
  • Para debatir mais a fundo sobre a documentação, será melhor usar o fórum da documentação do Moodle em português.

Documentação para colaboradores pt_br:MoodleDocs:Manual_Para_Colaboradores