Projeto:Ajuda sob domínio público
 Project:PD help is a project to create a set of concise user help pages for MediaWiki users, i.e. for visitors to a website which is powered by MediaWiki. The project covers all content in the Help namespace. The main entry point for this is Ajuda:Conteúdo. This help documentation is separate from the Manual (the GFDL and CC BY-SA-licensed MediaWiki administrator's manual). Contributors, please be clear about the differences! The PD help pages do not contain information for server administrators, about how to install, configure, or maintain MediaWiki software. See the 'Goal' section below, for a detailed statement of what we are trying to achieve.
|
Objetivo
O objetivo é fornecer um conjunto de páginas que possam ser copiadas durante a instalação de uma wiki ou incluidas na distribuição do MediaWiki. Isso incluirá informações básicas ao usuário e outros tópicos sobre sua wiki de forma razoavelmente concisa. O conceito básico é criar um “Guia do Usuário” compacto, e não um documento de referência. Estaremos focando no que os usuários querem, não em explicar funções.
Licença
Contribuições ao projeto são lançadas como domínio público através da renúncia CC0. Isso é necessário para permitir que os usuários possam copiar o texto com facilidade para dentro das instalações de suas wikis. Antes de contribuir, certifique-se de que você entende o seguinte:
- Toda página pertencente ao projeto deve conter a linha
{{PD Help Page}}para indicar essa licença. - Nenhum conteúdo poderá ser copiado para dentro dessas páginas, sendo as únicas exceções:
- O conteúdo copiado é de autoria sua, ou você possui permissão por escrito dos autores originais.
- Conteúdo já em domínio público pode ser copiado; entretanto, isso NÃO é o caso da maioria das páginas na internet!
- Você está renunciando a todos os direitos no tocante às informações depositadas aqui. Embora continue a ter suas contribuições listadas e atribuidas nesse website, qualquer um pode copiar o texto sem dar crédito, e modificar o quanto quiser.
Público alvo: Usuários comuns
As páginas de ajuda têm como alvo principal os visitantes comuns de uma wiki.
E não administradores de servidores
Não estamos visando duplicar a documentação inteira do MediaWiki. Toda informação direcionada a administradores de servidores, que esmiuce sobre instalação, configuração ou manutenção do MediaWiki, pertence ao Manual.
A única e pequena exceção a isso são as caixas “Dicas aos administradores” (descritas abaixo).
Informações para usuários administradores/burocratas menos proeminentes
As páginas de ajuda não seriam completas sem também descrever o que usuários administradores podem fazer. Entretanto, esses recursos avançados não estão disponíveis para a maioria do público alvo (usuários de uma wiki). Como tal, essa informação será mantida um tanto quanto separada da maioria do conteúdo, de forma com que os usuários normais não sejam confrontados com informações irrelevantes a eles.
Dentro do conjunto das páginas de ajuda, quando necessário, breves menções são feitas sobre ações que requiram privilégios administrativos; entretanto, descrições detalhadas de procedimentos para administradores devem ser colocadas em páginas com ligações menos proeminentes, ou estarem de fora das páginas de ajuda.
Essa seção está sob discussão (em inglês)
Diretrizes editoriais
- Crie ligações entre as páginas, mas evite ligações a outros espaços nominais do MediaWiki.org. Mantenha internas essas ligações às páginas de ajuda sob domínio público, ou faça ligações externas (de URL completa) aos recursos relevantes, p. ex., […] no meta.wikimedia.org, […]. Isso facilita a cópia do texto em instalações novas. Não utilize ligações interwiki, já que elas podem não existir na wiki em que as páginas forem copiadas.
- Na grande maioria dos casos, não usaremos a sintaxe {{SITENAME}} em lugar nenhum. MediaWiki é o nome do software sendo descrito. Esse é o CMS (sistema de gerenciamento de conteúdo) que permite a execução da wiki; portanto, sempre que nosso texto se referir ao software, deveremos usar literalmente o nome “MediaWiki”, sem substituições. Se, por alguma razão, o texto de ajuda estiver mencionando o nome do website, aí sim teremos uma exceção apropriada à regra (utilizaremos {{SITENAME}}). Ainda assim, não faremos isso onde mencionarmos a palavra MediaWiki.
- Traduções devem ser feitas após a versão em inglês de uma página atingir um nível estável. A convenção de nomes é
Título da página/código de idioma(p. ex.: Ajuda:Edição/pt-br). - A menos que você tenha a solução perfeita para navegar nesse manual, evite criar predefinições de navegação. Antes, foque na criação de conteúdo.
- Não utilize extensões como Cite, já que nem todas as instalações do MediaWiki as têm por instaladas.
Formatação
- A formatação deve ser consistente. Utilize
class="wikitable"para todas as tabelas que criar,{{Hl1}}para destacar células ou linhas, etc. - Toda marcação e código wiki devem ser envoltos por
<code>ou<pre>. Ajuda para inseri-los:{{subst:nw|text}}. - Todas as referências a textos e descrições de menus devem aparecer em itálico.
Imagens de captura de tela
Capturas de tela são úteis. As páginas de ajuda sob domínio público não precisam conter somente capturas de tela sob domínio público (embora logotipos com marca registrada estejam proibidos de serem usados nelas). Screenshots should be uploaded to Wikimedia Commons and use the {{MediaWiki screenshot}} license template.
Imagens podem ser adicionadas à documentação ou acessadas do Commons via InstantCommons.
Dicas para administradores
Se algo na Ajuda puder ser configurado por um administrador do servidor, é possível inserir uma “dica para administradores” com {{Dica para administradores}}.
Categoria
Todas as páginas no espaço nominal “Help:” são, por definição, parte desse projeto de documentação da Ajuda sob domínio público, e devem ser categorizadas sob Categoria:Ajuda. Páginas de ajuda para extensões do MediaWiki devem ser categorizadas em sua subcategoria Categoria:Ajuda sobre extensões.
Anteriormente, a categoria utilizada para páginas no espaço nominal “Help:”, integrantes desse projeto de documentação da Ajuda sob domínio público, era Category:PD help. Para simplificar o processo, a categoria agora se chama Categoria:Ajuda e todas as páginas foram movidas para ela.
Ver também
- Projeto:Política linguística – Se tiver interesse em trabalhar com versões traduzidas das páginas de ajuda.
- Project:PD help/export – Discute um método proposto para criar “despejos” de artigos do espaço nominal “Ajuda:” que sejam utilizáveis. Isso não está em estágio funcional, mas somente em discussão.