Project:PD help/pt-br
|
Project:PD help é um projeto para criação de um conjunto de páginas de ajuda concisas para usuários do MediaWiki, p.ex. para os visitantes de um site funcionando com MediaWiki. O projeto abrange todo o conteúdo do namespace Help. O ponto de entrada principal para ele é Help:Contents. Esta documentação de ajuda está separada do Manual (o manual do administrador do MediaWiki licenciado por GFDL). Contribuintes, por favor, estejam cientes sobre as diferenças! As páginas de ajuda PD não contêm informações para os administradores do servidor, sobre como instalar, configurar ou manter o software MediaWiki. Veja a seção Objetivo abaixo, para uma descrição detalhada do que estamos tentando alcançar.
|
[edit] Projeto: Ajuda de domínio público
Contents |
[edit] Objetivo
A idéia é fornecer um conjunto de páginas que podem ser copiadas para uma instalação wiki nova, ou incluídas numa distribuição mediawiki. Isso vai incluir informações de usuário básicas e outras informações do Meta, de uma forma razoavelmente concisa. O conceito básico é criar um guia do usuário compactado, não uma obra de referência. Deve concentrar-se no que os usuários querem e não explicar outras funções.
[edit] Licença
Contribuições para o PD Help são publicadas como domínio público (em vez do habitual GNU Free Documentation License). Isto é necessário, a fim de permitir que as pessoas facilmente copiem o texto em suas próprias instalações wiki. Por favor, certifique-se de entender os seguintes tópicos antes de contribuir:
- Cada página no PD Help deve conter a linha
{{PD Help Page}}para indicar a licença. - Nenhum conteúdo pode ser copiado de outro lugar para essas páginas, exceto se você for o autor ou tiver permissão dos autores. Conteúdo que é já de domínio público pode ser copiado para cá, mas isso não inclui a maioria das páginas web!
- Você está abandonando todos os direitos sobre a informação que você contribuir aqui. Embora você continuará a ter suas contribuições constantes e atribuídas a este site, outras pessoas podem copiar o texto sem dar crédito, e podem modificá-lo como acharem melhor.
[edit] Leitores alvo - Usuários comuns
As páginas de ajuda estão bastante dirigidas aos visitantes normais a um site wiki.
[edit] Não-administradores de servidor
Nós não estamos com o objetivo de duplicar a documentação completa MediaWiki. Informações orientadas para administradores de servidor, detalhando a instalação, configuração ou manutenção do MediaWiki, pertencem ao Manual.
A única exceção são as caixas 'Admin tips' (descritas abaixo).
[edit] Informações para sysops / burocratas menos proeminentes
As páginas de ajuda não seria completa sem também descrever o que sysops podem fazer. No entanto, esses recursos mais avançados não estão disponíveis para a maioria do público-alvo (a maioria dos usuários wiki). Como tal, esta informação deve ser mantida um pouco separada, de modo que usuários normais não são confrontados com a informação que não é relevante para eles. Dentro da maior parte das páginas de ajuda haverá uma breve descrição dos itens que requerem privilégios de sysop, mas as descrições detalhadas dos procedimentos do Sysop devem ser guardadas em páginas relacionadas com menos destaque, ou deve ser deixado de fora das páginas de ajuda completamente.
Esta seção está em discussão
[edit] Diretrizes editoriais
- Crie links entre as páginas, mas evite ligar a outros namespaces no MediaWiki.org. Mantenha os links internos para as páginas de ajuda de domínio público, ou fazer ligações externas (URL completa) para recursos relevantes, por exemplo, no meta.wikimedia.org. Isso é para facilitar a cópia do texto em instalações novas. Não use links interwiki, que estes não podem existir no wiki alvo.
- Nós provavelmente não queremos trocar a sintaxe {{SITENAME}} em qualquer lugar. MediaWiki é o nome do software que estamos descrevendo. Este é o software que alimenta o wiki de destino; então, em qualquer lugar onde nosso texto esteja se referindo ao software (por toda a ajuda) deve ser deixado como uma string literal "MediaWiki". Se por algum motivo, o texto de ajuda estiver mencionando o nome do site, então esta seria uma exceção apropriada (use {{SITENAME}}), mas não trocaremos isso em todos os lugares onde podemos citar a palavra MediaWiki.
- Traduções devem ser efetuadas após a versão em inglês da página em questão atingir um status de conteúdo estável. A convenção de nomenclatura é
Título da página/código de idioma(ex.: Help:Editing/pt-br).
- A menos que você tenha a solução perfeita para a navegação neste manual, por favor, evite criar modelos de navegação; crie o conteúdo primeiro.
- Não utilize extensões como Extension:Cite, uma vez que não estão presentes em todas as instalações do MediaWiki
[edit] Formatação
- A formatação deve ser consistente. Use
{{Prettytable}}para todas as tabelas que você criar, realce células ou linhas com{{Hl1}}etc. (veja Template talk:Prettytable)
- Todas as marcações wiki e o código devem ser colocados entre tags
<code>or<pre>. Ajuda para inserção:{{subst:nw|text}}.
- Todas as referências a textos de menus e descrições devem aparecer em itálico.
[edit] Imagens de tela
Imagens de tela podem ser úteis. Páginas do PD help devem conter apenas imagens de domínio público; isso pode ser facilmente alcançado evitando logos e enviá-los para o Commons com {{MediaWiki screenshot}} (para GPL) e licenças {{CC-zero}} (para trabalhos de usuários).
As imagens serão, então, enviadas com a documentação ou utilizadas a partir do Commons com o InstantCommons.
[edit] Admin tips
Se algo no namespace puder ser configurado por um administrador de sistema, você pode inserir uma admin tip. Veja a predefinição admin tip.
[edit] Categorização
Todas as páginas no namespace Help: são, por definição, parte deste projeto de documentação de domínio público da Ajuda e devem ser categorizadas Category:Help se estiverem em inglês, o idioma padrão do MediaWiki.org, se não estiverem, Category:Help/fr (em francês), Category:Help/de (em alemão), etc.
A primeira categoria de páginas no namespace Help:, este projeto de documentação de domínio público da Ajuda, era Category:PD Help. De acordo com a simplicidade, a categoria agora é simplesmente Category:Help e todas as páginas foram atualizadas.
[edit] Veja também
- Project:Language policy: se você estiver interessado em trabalhar nas versões em outros idiomas das páginas de ajuda.
- Export: discute o método proposto de criação de depósitos utilizáveis do namespace Help:. Isso ainda está em fase de discussão e ainda não está funcionando.
- Mirroring: discute um método alternativo de obtenção de conteúdo a partir do MediaWiki.org que pode ser usado no intervalo.