Ajuda:Contribuir

From KDE TechBase
Revision as of 14:02, 17 October 2019 by Juliano Assis (talk | contribs)
Other languages:

Esta página contém informações sobre a edição da wiki do KDE TechBase, incluindo conteúdo, sua localização e ferramentas úteis específicas desta wiki. Mesmo se você estiver familiarizado com os wikis, você deve ler a seção sobre organização para ver qual conteúdo deve ser colocado nesta wiki.

Antes de você começar

Começando pelo começo

  • Lembre-se de que você deve concordar que suas contribuições lançadas nesta wiki estão sob as licenças listadas em KDE TechBase: Copyrights. Essas licenças significam que o que você escreve pode ser copiado para outros sites, por exemplo.
  • Use as Páginas de discussão para se comunicar com outros colaboradores ou obter ajuda. Normalmente, alguém responderá dentro de um dia.

Relevância

Este wiki é para documentação de desenvolvedores que desejam usar ou estender produtos KDE (por exemplo, via APIs) ou:

  • informações gerais para bibliotecas, incluindo as vantagens de usá-las
  • tutoriais e exemplos para usar bibliotecas
  • tutoriais, exemplos e documentação para escrever plugins e outras extensões para bibliotecas e aplicativos
  • Interfaces IPC / RPC para software, como interfaces DBus


A documentação do usuário final pertence a UserBase, e as coisas direcionadas a colaboradores, equipes e a Comunidade KDE em geral pertencem a the community wiki.

Exemplos de coisas que não pertencem a TechBase incluem:

  • documentação sobre como usar um aplicativo
  • políticas de estilo de código
  • informações para novos colaboradores
  • coordenação da equipe (listas de TODO, anotações de reuniões etc.)
  • notas sobre a arquitetura interna de um software (mas a arquitetura da API de uma biblioteca pertence)

Mais sobre isso em em diretrizes sobre community.kde.org

Organisation

noframe
noframe
 
TODO
necessário documentar a estrutura

Formatting

Wiki Maintenance

Maintaining a clean and useful wiki involves making sure content is up to date, there are no broken links, and all pages can be found (they are linked to from somewhere). The following special pages can help find issues that need fixing:

Issues which should be fixed as soon as possible
Special:Lonelypages
Special:BrokenRedirects
Special:DoubleRedirects
Issues which should be fixed in time
Special:Wantedpages
Special:Wantedcategories

You can also add a page to the Needs Attention to flag it for later work by adding [[Category:Needs Attention]] to the page. Using Template:TODO will also add a page to this category.

Deleting pages

Most users cannot delete pages on the Wiki - this is because once a page is gone, you cannot get it back. If you think a page should be deleted, mark it with Template:Proposed_deletion at the top:

{{Proposed_deletion|reason=this page contains only spam}}