Help:Contribute/pt-br: Difference between revisions

From KDE TechBase
(Created page with "Ajuda:Contribuir")
 
No edit summary
 
(29 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>


This page contains information about editing the KDE TechBase wiki, including what content belongs where and helpful tools specific to this wiki. Even if you are familiar with wikis, you should read [[#Organisation|the section on organisation]] to see what content should be put where on this wiki.
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 [[#Organisation|a seção sobre organização]] para ver qual conteúdo deve ser colocado nesta wiki.


==Before you Start==
==Antes de você começar==


===First Things First===
===Começando pelo começo===


* To contribute to TechBase you must register an account with the [https://identity.kde.org KDE Identity service], then activate it on [https://phabricator.kde.org Phabricator] by logging in there, and then you can click the [[Special:PhabricatorLogin/redirect|Login with Phabricator]] link on the sidebar to log in.
* Para contribuir com a TechBase, você deve registrar uma conta no [https://identity.kde.org KDE Identity service] e então ativá-la no [https://phabricator.kde.org Phabricator] fazendo login por lá e, em seguida, você pode clicar no link [[Special:PhabricatorLogin/redirect|Login with Phabricator]] na barra lateral para fazer login.


* Be aware that you must agree to your contributions to this wiki being released under the licenses listed at [[KDE TechBase:Copyrights]]. These licenses mean that what you write might be copied to other sites, for example.
* 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 the [https://www.mediawiki.org/wiki/Help:Talk_pages Talk pages] to communicate with other contributors or get help. Normally someone will get back to you within a day.
* Use as [https://www.mediawiki.org/wiki/Help:Talk_pages Páginas de discussão] para se comunicar com outros colaboradores ou obter ajuda. Normalmente, alguém responderá dentro de um dia.


===Relevance===
===Relevância===


This wiki is for documentation for developers wanting to use or extend KDE products (e.g. via APIs), or:
Este wiki é para documentação de desenvolvedores que desejam usar ou estender produtos KDE (por exemplo, via APIs) ou:


* overview information for libraries, including the advantages of using them
* informações gerais para bibliotecas, incluindo as vantagens de usá-las
* tutorials and examples for using libraries
* tutoriais e exemplos para usar bibliotecas
* tutorials, examples and documentation for writing plugins and other extensions to libraries and applications
* tutoriais, exemplos e documentação para escrever plugins e outras extensões para bibliotecas e aplicativos
* IPC/RPC interfaces for software, like DBus interfaces
* Interfaces IPC/RPC para software, como interfaces DBus




End-user documentation belongs on [https://userbase.kde.org UserBase], and things directed at contributors, teams and the KDE Community in general belong on [https://community.kde.org the community wiki].
A documentação do usuário final pertence a [https://userbase.kde.org UserBase], e as coisas direcionadas a colaboradores, equipes e a Comunidade KDE em geral pertencem a [https://community.kde.org the community wiki].


Examples of things that '''don't''' belong on TechBase include:
Exemplos de coisas que '''não''' pertencem a TechBase incluem:


* documentation on how to use an application
* documentação sobre como usar um aplicativo
* code style policies
* políticas de estilo de código
* information for new contributors
* informações para novos colaboradores
* team coordination (TODO lists, meeting notes, etc)
* coordenação da equipe (listas de TODO, anotações de reuniões etc.)
* notes on the internal architecture of a piece of software (but the architecture of a library's API does belong)
* notas sobre a arquitetura interna de um software (mas a arquitetura da API de uma biblioteca pertence)


More on this on the [https://community.kde.org/Guidelines_and_HOWTOs/Documentation_in_wikis guidelines on community.kde.org]
Mais sobre isso em [https://community.kde.org/Guidelines_and_HOWTOs/Documentation_in_wikis em diretrizes sobre community.kde.org]


==Organisation==
==Organisation==


{{TODO|need to document the structure}}
{{TODO|necessário documentar a estrutura}}


==Formatting==
==Formatação==


* The main MediaWiki site has [http://www.mediawiki.org/wiki/Help:Formatting a Wiki syntax guide]
*O site principal do MediaWiki possui [http://www.mediawiki.org/wiki/Help:Formatting o Wiki syntax guide]
* UserBase has some [https://userbase.kde.org/Toolbox lists of formatting] that can be a useful reference, including templates that are specific to the KDE wikis.
*O UserBase possui algumas [https://userbase.kde.org/Toolbox listas de formatação] que podem ser uma referência útil, incluindo modelos específicos das wikis do KDE.
* Much of what applies to Wikipedia (except the templates) also applies here, including [http://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] and their [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet cheatsheet].
*Muito do que se aplica à Wikipedia (exceto os templates) também se aplica aqui, incluindo [http://en.wikipedia.org/wiki/Help:Wiki_markup Wiki markup] e suas [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet cheatsheet].


==Wiki Maintenance==
==Manutenção da Wiki==


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:
Manter uma wiki limpa e útil envolve garantir que o conteúdo esteja atualizado, que não haja links quebrados e que todas as páginas possam ser encontradas (elas estão vinculadas a partir de algum lugar). As páginas especiais a seguir podem ajudar a encontrar problemas que precisam ser corrigidos:


; Issues which should be fixed as soon as possible
;Problemas que devem ser corrigidos o mais rápido possível
:[[Special:Lonelypages]]
:[[Special:Lonelypages]]
:[[Special:BrokenRedirects]]
:[[Special:BrokenRedirects]]
:[[Special:DoubleRedirects]]
:[[Special:DoubleRedirects]]


; Issues which should be fixed in time
;Problemas que devem ser corrigidos a tempo
:[[Special:Wantedpages]]
:[[Special:Wantedpages]]
:[[Special:Wantedcategories]]
:[[Special:Wantedcategories]]


You can also add a page to the [[:Category:Needs Attention|Needs Attention]] to flag it for later work by adding <nowiki>[[Category:Needs Attention]]</nowiki> to the page. Using [[Template:TODO]] will also add a page to this category.
Você também pode adicionar uma página à [[:Category:Needs Attention|Needs Attention]] para sinalizá-la para trabalhos posteriores, adicionando <nowiki>[[Category:Needs Attention]]</nowiki> à página. O uso do [[Template:TODO]] também adicionará uma página a esta categoria.


===Deleting pages===
===Excluindo páginas===


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:
A maioria dos usuários não pode excluir páginas na Wiki - isso ocorre porque, uma vez que uma página desaparece, você não pode recuperá-la. Se você acha que uma página deve ser excluída, marque-a com [[Template:Proposed_deletion]] na parte superior:


{{Input|1=<nowiki>{{Proposed_deletion|reason=this page contains only spam}}</nowiki>}}
{{Input|1=<nowiki>{{Proposed_deletion|reason=this page contains only spam}}</nowiki>}}

Latest revision as of 14:16, 17 October 2019

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

Formatação

  • O site principal do MediaWiki possui o Wiki syntax guide
  • O UserBase possui algumas listas de formatação que podem ser uma referência útil, incluindo modelos específicos das wikis do KDE.
  • Muito do que se aplica à Wikipedia (exceto os templates) também se aplica aqui, incluindo Wiki markup e suas cheatsheet.

Manutenção da Wiki

Manter uma wiki limpa e útil envolve garantir que o conteúdo esteja atualizado, que não haja links quebrados e que todas as páginas possam ser encontradas (elas estão vinculadas a partir de algum lugar). As páginas especiais a seguir podem ajudar a encontrar problemas que precisam ser corrigidos:

Problemas que devem ser corrigidos o mais rápido possível
Special:Lonelypages
Special:BrokenRedirects
Special:DoubleRedirects
Problemas que devem ser corrigidos a tempo
Special:Wantedpages
Special:Wantedcategories

Você também pode adicionar uma página à Needs Attention para sinalizá-la para trabalhos posteriores, adicionando [[Category:Needs Attention]] à página. O uso do Template:TODO também adicionará uma página a esta categoria.

Excluindo páginas

A maioria dos usuários não pode excluir páginas na Wiki - isso ocorre porque, uma vez que uma página desaparece, você não pode recuperá-la. Se você acha que uma página deve ser excluída, marque-a com Template:Proposed_deletion na parte superior:

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