Phabricator/Help/pt-br

Estimado utilizador do Phabricator, se tiver questões, basta perguntar na página de Discussão. Nós melhoramos a nossa documentação baseando-se no retorno (feedback) que recebemos. Se quiser testar o Phabricator, deve utilizar o Labs instance.

Para uma vista básica sobre o que o é Phabricator e o que o pode fazer,. Pode ainda continuar a ler esta página para aprofundar e fazer uma introdução.

Criando sua conta



 * Primeiro, certifique-se que está no Wikimedia.
 * Se não tiver ainda uma conta na Wikimedia, para uma.
 * Vá para Página de acesso de conta do Phabricator (A ligação aparece como uma seta para uma porta, no topo direito quando tiver terminado a sessão da sua conta).
 * Clique no botão girassol que diz "Aceda ou Registe-se - MediaWiki".
 * Você será informado que aguardará pela MediaWiki.org para aprovar a conexão.
 * Phabricator solicitará o seu nome de utilizador. Em caso de dúvidas, apenas utilize o seu nome de utilizador do Wikimedia, mas note que o nome de utilizador do Phabricator não poderá conter caracteres que não sejam caracteres em Latin (non-Latin characters), tal como  العَرَبِيةُ ou 中华民族, nem incluir espaços (por favor, utilize ao invés disso o sublilnhado " "). Um endereço válido de e-mail também será requerido para verificação, mas não será visível para os outros utilizadores.
 * Se notar que sua conta do Phabricator foi desactivada, por favor mencione em Discussão:Phabricator/Ajuda. Se não receber um retorno num espaço curto de tempo, contacte o Bugwrangler.
 * Clica em Gerenciar na barra de navegação à esquerda.
 * Clique Editar Perfil e defina o seu "Também Conhecido Por" (por exemplo, para o seu nome completo) para mais facilmente poder ser localizado.


 * Avançado
 * Se você tiver uma conta de desenvolvedor da Wikimedia &mdash; também conhecida como conta LDAP ou conta Gerrit, ou ainda conta wikitech — também poderá usá-la para para iniciar a sua sessão. O mesmo nome de utilizador do Phabricator pode ter tanto o MediaWiki.org como LDAP conectado. Este pode ser dados alternância, para a improvável eventualidade de o Wikimedia SUL não estiver a funcionar. Conecte as suas contas Wikimedia SUL e  LDAP para um único nome de utilizador do Phabricator! De outra forma, criará duas contas separadas no Phabricator.
 * Nós não encorajamos a utilizar autenticação multi-factor no Wikimedia Phabricator. Se ainda pretender utilizar isto, leia primeiro o guia de autenticação multi-factor.

Solicitando as suas contas Bugzilla e RT
Siga a ligação aqui.

Recebendo atualizações e notificações
O Phabricator notifica-o sobre atividades relevantes, incluindo suas próprias ações. Pode ajustar suas preferências de e-mail como lhe convir, recebendo notificações da web apenas por certas atividades ou para não receber nenhuma notificação de todo.

O Phabricator dispõe de várias ferramentas para notificações que desejar receber.

Você pode também definir em suas Preferências de e-mail, acções específicas (ex: estatuto, proprietário, prioridade ou alterações do subscritor) em uma tarefa que gostaria ou não de receber notificações. Utilizadores prolíficos, devem querer reduzir definições de e-mails para um mínimo, tal como em File:Phabricator email settings panel.png. Como membro de um projecto, você pode optar por sair da correspondência do e-mail do projecto através do  na página "Membros" do projecto. Existe informação disponível no guia do usuário Gerindo E-Mail do Phabricator.
 * Se tiver interessado em um único tema (uma tarefa, um protótipo...) clique apenas em  nesta página. Adicionando um comentário subscrevê-lo-á automaticamente.
 * Se tiver interessado em todas as atividades em um projeto, pode clicar em  na página do Resumo do projeto. Existe informação adicional no guia do utilizador Projects embaixo de "Watching Projects".

Criando regras para o sinalizador de Notificações
Siga esta ligação para saber como criar regras de notificação "personalizada" em Notificações do Wikimedia Phabricator. Este é a opção mais avançada e pode ser difícil de utilizar.

Criando uma tarefa
There are several ways to create a task, depending on the information you want to carry: Preencha o formulário, deixando em branco os campos que você tiver dúvidas.
 * A new task: click the Star button toward the right side of the top navigation bar. From the dropdown menu, choose Create Task. You will get a blank form.
 * Um problema de segurança: clique no botão Estrela em direção ao lado direito da barra de navegação superior. No menu suspenso, escolha Report Security Issue. Você receberá um formulário pré-etiquetado com Segurança e com um link para instruções especiais para a apresentação de erros de segurança.
 * Uma sub-tarefa para a tarefa existente: Clique em Criar sub-tarefa que se encontra na coluna direita da tarefa actual. A dependência entre ambas as tarefas será definida, e alguns dos valores da tarefa principal serão transportados por definição (Atribuído para, Subscritores, Prioridade, Projectos). Sub-tarefas serão listadas na tarefa principal sob "Gráfico de Tarefas", ordenadas por actualizações mais recentes.

Formatação
O Phabricator suporta algumas formatações de áreas de textos. Ver esta ajuda sobre formatação no Phabricator.

Selecionando Projetos
De formas a reportar as tarefas com uma etiqueta project que usa o Phabricator, você precisa apenas de começar a escrever o seu nome no campo Tags e selecionar o projeto a partir da lista dos projetos correspondentes (a lista mostrará apenas cinco projetos correspondentes). Você pode também pesquisar por projetos clicando no ícone da lupa no campo Tags e ler pequenas descrições dos projetos. Você pode adicionar um ou mais projetos no campo Tags. Se estiver incerto, pode também deixar isto vazio — triagens cuidarão de tarefas que não têm projetos definidos. Existe uma (longa) lista de projetos disponível. Accione  para pesquisar por projetos. (Esta lista está também disponível em Phabricator/Projetos).

Definindo a prioridade da tarefa
Prioridade deve geralmente ser definida por gerentes do produto, mantedores, ou desenvolvedores que pretendam trabalhar em uma tarefa ou por um vigilante de erros ou membros experientes da comunidade, mas não por um relator preenchendo o relatório de erros ou pelo observadores externos. Ver Gestão de Projeto do Phabricator para mais detalhes.

Utilizando e-mail
Pode também criar tarefas enviando e-mail para [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. O foco será utilizado como título da tarefa, o corpo será utilizado diretamente como está, e os anexos serão incluídos na tarefa. Para definir o projcto, adiciona o comando correspondente !projects e a respectiva hashtag no início do corpo, exemplo,. Comandos adicionais para definir o designatário da tarefa, prioridade ou estatuto via e-mail estão disponíveis.

Nota: Se a assinatura de seu e-mail não estiver formatado seguindo os padrões de fato (incluindo -'' para estar separado do corpo do texto), ainda assim será publicado. É-lhe encorajado a remover informações privadas da sua assinatura na sua primeira tentativa, apenas para se certificar.''

Passando certos valores no URL criação de tarefa
A ligação Reporte um erro no Phabricator pode passar valores numerosos através dos parâmetros do URL, adicionado à ligação de criação de tarefa genérica.

Esta é uma funcionalidade muito avançada. Saiba mais aqui.

Responder aos comentários e marcação
To reply, you need an account as well, which is basically your Wikimedia username.

Escrevendo comentários e descrições
O Phabricator permite que você publique e edite descrições utilizando formatação de texto e insira imagens ou outros ficheiros; ver Carregando anexos de ficheiros. Pode utilizar a barra de ferramenta no topo da entrada da área texto e pode utilizar o Remarkup do Phabricator. No fim da página você tem uma visualização em tempo real que permite verificar se a aparência do seu texto corresponde ao esperado. O uso popular de hipermarcação inclui:
 * Mencionar utilizadores tal como  criará uma ligação para os respectivos perfis dos utilizadores e os subscreverá para a tarefa.
 * Adicionando um número da tarefa tal como  criará uma ligação para a tarefa incluindo um cartão flutuante.   insere o título da tarefa no seu texto.
 * Adicionando um nome para o projecto tal como  criará uma ligaçã para o projecto principal.
 * Se quiser um texto de citação, pode simplesmente adicionar  no início. Se quiser responder a um comentário incluindo-o como citação, clica na seta à direita do fim do comentário que quiser responder.
 * Se quiser mostrar um ficheiro de imagem do modelo que foi carregado, ex:, inserido em seu comentário, escreva.
 * Se quiser criar uma ligação externa, ex:  na hipermarcação da wiki, use   incluindo os espaços em branco em Phabricator.
 * Se quiser adicionar um endereço web (ligação URL) em um comentário por exemplo para fornecer um testcase, é altamente recomendado que se copie e cole o endereço completo da barra de endereço do navegador, ex:  ao invés de  . Prefixos Interwiki como em   não são suportados no Phabricator e a maioria das personalizações que o Bugzilla teve nem, ex: Alterações do Gerrit devem também ser coladas como endereço completo.
 * Se quiser colar linhas de código, adicione uma linha com três acentos graves antes e depois do código: . Ou Cria uma Paste e ligue à Paste a partir da tarefa.

Note que a linguagem de hipermarcação do Phabricator é diferente da linguagem de hipermacação do MediaWiki. A instância de upstream do Phabricator hospeda uma Referência de Remarkup para a própria linguagem de hipermarcação.

Carregando anexos de arquivos
Existe várias formas de carregar arquivos: Você pode adicionar um arquivo (por exemplo uma foto do ecrã) em um comentário ou descrição de tarefa, arrastando-a com o seu rato. Usuários podem de igual modo copiar e colar imagens através da funcionalidade da área de transferência do seu sistema.

Se não tiver disponível em seu sistema, poderá utilizar phabricator:file/upload e referir ao número do arquivo, (tal com "123)" que é mostrado depois de um carregamento de arquivo ser bem sucedido, escrevendo  em um comentário. Isto criará uma ligação ao arquivo. Para incluir o arquivo no comentário, feche-o em chavetas, ex:. Pré-definidos são incluídos como miniatura. Para mais opções de formatação, visite Referência Remarkup. Se tiver frequentemente de carregar arquivos e considerar as opções disponíveis atualmente como desconfortáveis, poderá também adicionar uma ligação direta na sua página inicial do painel do texto.

Usuários avançados podem também utilizar o carregamento arc que disponibiliza um número F que pode ser utilizado através da syntax  para incluir em um comentário.

Note que não poderá carregar um arquivo e a seguir reduzir o nível de acesso do mesmo (exemplo: ligando-o a uma marca de segurança restrita). Você teria de eliminar o arquivo e voltar a reenviá-lo com níveis de acesso mais restritos. É recomendado que se carregue ficheiros que se pretende ter acesso mais restrito junto com a criação de uma marca restrita (security). Mais adiante, note que qualquer pessoa com acesso ao URL completo para o ficheiro pode descarregar o arquivo ou ainda partilhar a ligação com outros. Não existe proteção para autenticação da origem da solicitação do acesso. Os arquivos do Phabricator confiam inteiramente na segurança por obscurantismo; adivinhando o URL pseudo-aleatório para qualquer arquivo dado será muito difícil. Se precisar de mais proteção para arquivos particularmente sensíveis, então deverá considerar uma alternativa mais segura.

Se alguma vez precisar de apagar um arquivo que carregou, abra o [[phabricator:file/query/authored/|list dos arquivos de sua autoria, seleciona o arquivo e clique Eliminar arquivo na barra lateral.

Gestão de projeto em Phabricator
Se mantém ou gere um projeto, por favor siga esta ligação para mais detalhes.

Tarefas principais e sub-tarefas
Tarefas podem ser principais tarefas ou sub-tarefas de qualquer número de outras tarefas. Tais relações podem ser definidas através de Editar Tarefas Relacionadas.... Esta característica pode ser utilizada para realizar diferentes pequenas coisas:

Parent tasks and subtasks are displayed under "Task Graph" in the task. NOTA: Existe uma funcionalidade "Editar Tarefas Relacionadas...>Criar Sub-tarefa". Além disso, para definir a relação correta entre Tarefa principal/Sub-tarefa, esta cuida igualmente da lista de (subscrição) CC na nova sub-tarefa.
 * Bloqueadores e Sub-tarefas. Uma tarefa (principal) poderia simplesmente estar bloqueada por outra (sub)tarefa, representando dependência (ver Phabricator/Project management em como adicionar sub-tarefa).
 * Tracking. A "workless" (parent) task blocked by several (sub)tasks might be tracking a collection of (sub)tasks within a release or other time period. Note that "Tracking" here has a different meaning from the deprecated #Tracking tag in Phabricator.
 * Aprovação. Várias tarefas (principais), (como draft team goals) poderiam estar bloqueadas por uma única (sub)tarefa que representa draft tasks sendo aprovadas, depois destas draft goals tornarem-se novos objetivos reais.

Priorização
Cada tarefa tem um campo Prioridade, que é reflectido na cor da barra lateral das Tarefas que aparecem nos Quadros de trabalho. Note que esta Prioridade é herdada para Tarefa, e portanto, será a mesma em todo o Projeto e Quadro de trabalho que a tarefa aparecer.

Dentro de um Quadro de trabalho, Tarefas podem ser ordenas por prioridade dentro de uma coluna. Escolha ordenamento Natural, e a seguir arreste as tarefas para cima ou para baixo dentro da coluna. Isto permite a um backlog acoplado ser sequenciado por prioridade, ou poderia indicar a urgência dos itens na coluna Precisam de Revisão. Note que as colunas do Quadro de trabalho podem também ser ordenadas pelo campo Prioridade abaixo, enquanto discute o Quadro de trabalho com alguém que esteja fora da sala, é o melhor concordar e usar a mesma ordem de ordenamento para evitar confusão.

Atribuição
Cada Tarefa pode ser atribuída a uma pessoa. Tal como Prioridade, esta é herdada para a Tarefa, e afeta todo o Projeto que a Tarefa estiver contida. Portanto é impossível ter uma tarefa atribuída por exemplo ao Robin em um projeto, e para Kim em outra. A pessoa designada é mostrada como parte do cartão de Tarefa em cada Quadro de trabalho.

Algumas equipes podem escolher atribuir Tarefas a pessoas enquanto as Tarefas estiverem na coluna TODO. Outras teriam pessoas com tarefas atribuídas a elas mesmas apenas no momento em que as tarefas estiverem a ser movidas da coluna TODO para coluna DOING (CORRENTE). Atribuindo uma Tarefa a si mesmo antes de estar preparado para trabalhar nela é uma forma de cookie licking.

Depois de o trabalho principal na Tarefa ser terminado, existem 2 padrões principais para atribuição:


 * A Tarefa continua atribuída a quem quer que seja que tenha feito o trabalho, considerando que seja o responsável permanente da tarefa.
 * A Tarefa é reatribuída a quem quer que seja que precisar de trabalhar nisto a seguir

Por exemplo, depois de o código tiver sido escrito, este pode precisar de uma revisão de uma pessoa específica. No segundo caso, a Tarefa será assinada para esta pessoa, tornando claro para o responsável por fazer a tarefa avançar. Obviamente se tiver múltiplas possibilidades de revisões dos códigos, este modelo não trabalhará. Posteriormente, se a questão estiver a espera de alguém para testá-la, ou lançá-la, ou rodar alguma tarefa específica necessária para ser completa (tal como uma re-indexação), a Tarefa poderá ser assinada para esta pessoa. O Equipe deve ter políticas para que tarefas completas devam ser atribuídas de volta para a pessoa que criou inicialmente criou-as, de modos a que elas possam verificar que suas necessidades são atendidas, e a tarefa preparada para se encerrada.

"DONE" (FEITO)
Cada tarefa tem um campo Status, que inclui o estado Resolved. Tarefas resolvidas (resolved tasks) são geralmente ocultadas do Quadro de trabalho. Quando forem mostradas, elas aparecerão acinzentadas e riscadas. Outros estatutos incluem Open e Stalled (Aberto e Estagnado).

Note que este estatuto Resolved é herdado para Task, e deste modo afetará a aparência e comportamento de todo o Projeto (e o Quadro de trabalho) que estiver contido. Este é independente da coluna em que a tarefa estiver, em qualquer Quadro de trabalho dado. Portanto a Task (Tarefa) poderia ser Open, e poderia estar na coluna DONE (FEITO) de uma área de trabalho, e contudo na coluna DOING (CORRENTE) de outra. Isto pode também estar na coluna (ano seguinte)  em qualquer lugar.

Como resultado, é importante não marcar a tarefa como resolvida até que esta é considerada terminada por ALL (TODOS) os projetos em que a tarefa estiver contida. É bom mover a Tarefa para seu próprio Quadro de Trabalho na coluna DONE, mas antes de marcar como Resolved, certifique-se que nenhum outro projeto continua a querer acompanhar o respectivo progresso.

Tarefas de Rastreamento ("Tracking" tasks)
Este termo veio de Bugzilla, onde teve um significado específico: Uma tarefa que estava bloqueada em outras, mas que por si só não representava nenhum trabalho, e que não estava ligada em uma data de liberação (release/date) específica. Um exemplo poderia ser uma Tarefa denominada Limpar a documentação, que poderia posteriormente ter uma variedade de sub-tarefas, que das quais iria subscrever a um trabalho específico a ser feito. Estas tarefas de Rastreamentos tendiam em ficar neste estado por muito tempo (ou para sempre), à medida que suas sub-tarefas seriam resolvidas e novas seriam criadas. No Phabricator, seria melhor criar uma (etiqueta) Projeto para categorizar este tipo de trabalho.

Note, contudo, existe outros tipos de tarefas menos trabalhosas que continuam a fazer sentido no Phabricator. Notavelmente, Liberar tarefas. Uma vindoura liberação poderia ser representada por uma Tarefa, que lista toas as sub-tarefas, todas os trabalhos de tarefas que estão marcadas para liberação. Uma vez liberada, poderá resolver-se. Uma similar utilização seria ter uma tarefa que representa um team overall goals for the quarter, e depois cada goal poderia (ou não) ser uma sub-tarefa bloqueada.

Pesquisando por itens


O Phabricator consiste de várias aplicações (gestão de tarefas em Maniphest sendo uma delas, e no futuro também Diffusion e Differential para revisão do código). A campo pesquisa no canto superior direito permite pesquisar sobre todas as aplicações.

Utilizando o Maniphest (Pesquisa Avançada)


O Maniphest é uma ferramenta que permite utilizadores fazerem pesquisas avançadas utilizando parâmetros múltiplos. As pesquisas podem também ser guardadas e geridas.

Novos usuários encontrarão várias linhas de texto de pesquisa pré-definidas dentro do Maniphest. Clicando em Pesquisa Avançada trará uma nova página de pesquisa.

Clique aqui para passagem detalhada pelo Maniphest.

Utilizando o painel
Painéis são páginas especialmente desenhadas que podem mostrar uma ampla variedade de informação. Estas podem ser criadas, geridas, e partilhadas entre usuários.

Clique para passagem detalhada pelo painel do Maniphest.

Edições em massa
O Phabricator dispões da possibilidade de executar edições massivas para tarefas. No fim de qualquer linha de texto de Pesquisa em Maniphest encontrará Edição Massiva Selecionada para editar todas as tarefas que tiver selecionado utilizando o Shift-Clique. Usuários querendo utilizar esta funcionalidade precisam de se juntar ao grupo Triagers.

Batch editing can be reversed by noting the "Bulk Job" ID that is generated at the start of a Batch Edit. This can be accessed by clicking "Details" before or after executing. On the following page, there will be a "Continue" menu item to the right, which will generate a Maniphest query of all the affected tasks.

Favoritos
O menu Star no topo da barra de navegação pode ser personalizado com os links dos formulários de suas ações e preferência. See the Profile Menu instructions for more information.

Lista pessoal de itens
A funcionalidade Sinalizar Para Depois permite marcar objetos (como tarefas ou revisões) que gostaria de executar posteriormente. Oito cores de sinalizadores estão disponíveis. Sinalizadores são pessoais e privados, portanto suas listas não poderão ser partilhadas com outros. Seus objetos sinalizados são listados em [sinalização]. Estes podem ser pesquisados por cor ou tipo de objecto, em contraste com [símbolos].

Criando um projeto


Nas etiquetas dos projetos do Phabricator, etiquetas são projectos. Hierarquia através do sub-projetos estão disponíveis desde Fevereiro de 2016. , Tarefas podem ser atribuídas a mais de um projeto, e estas podem igualmente ser submetidas sem atribuí-las a qualquer projeto.

Quando é que você precisa de um projecto
Em geral, você precisa de um projecto...
 * Quando tiver um grupo estabelecido rodando um ou mais projectos (inicie aqui, ou pergunte mais apenas quando precisar)
 * Quando você precisa de um quadro de trabalho (i.e. um sprint)
 * Quando você precisar de marcar ou palavra chaves para organizar o tipo de tarefa que pode ser parte de qualquer projeto (por exemplo Acessibilidade)

Solicitando um novo projeto
Ver Phabricator/Solicitando um novo projeto.

Restringindo acesso a tarefas
Please see Phabricator/Security for a general overview and the dedicated task creation form. See Phabricator/Creating and renaming projects for default project settings (and using Spaces).

Mostrando e utilizando um Espaço


''Espaços (documentação upstream) permite restringir acesso a grupos ou objectos (tal com tarefas) a apenas membros de um grupo específico. ver Restringindo acesso através de políticas Espaços para configurar.''

If you can access at least two spaces, you see an additional Spaces dropdown under "Visible To" when creating and editing an object. Users with access to only one space will not see this control.



Em visualização de tarefa do Maniphest, o Espaço também será mostrado frente ao resumo. Você pode editar-em-massa tarefas para movê-las para um Espaço diferente.

Note que você continuará a estar associado ao projeto público correspondente (se existente) a uma tarefa para tornar a tarefa em um Espaço restrito (que tiver acesso) para mostrar nas linhas de texto para pesquisa e no quadro de trabalho do projeto. O projeto público poderia ser automaticamente adicionado através de Solicitando uma regra geral de notificação.

Quando tiver a criar tarefas em Spaces, utilize a opção Create Advanced Task no submenu Create Task. Esta opção mostrará Spaces adicionais no submenu em baixo de Visible To na criação da tarefa UI que o permitirá definir a visibilidade para o Space para a qual a tarefa deve ser visível.

Se ao invés você tiver criar a tarefa através da opção Create Simple Task do submenu, então, depois de criar, você terá que editar a tarefa para restringir a visibilidade aos membros do Space. Antes de editar, a tarefa estará visível para qualquer pessoa e as notificações relacionadas com a sua tarefa deverão ter sido enviadas ao público conectado aos canais IRC e outros indivíduos subscritos.

Ligações e templates do MediaWiki

 * Você pode ligar-se as tarefas do Phabricator a partir das páginas wiki utilizando  e a versão mais reduzida , por exemplo   gera exemplo.
 * Template:Tracked foi atualizado para incluir ligações aos objetos do Phabricator —  ver como   é mostrado.
 * Template:Phabricator também disponível;  gera.

As ligações e templates existentes continuarão a trabalhar, porque aquelas ligações continuarão a apontar par bugzilla.wikimedia.org que os direcionará para tarefa convertida do Phabricator.

Utilizando Conferência
Conferência é uma aplicação do Phabricator que permite ativa conversações entre dois ou mais utilizadores, parecendo-se com aplicações de mensagens e salas privadas. Nenhuma equipe é conhecida por utilizar isto. Isto pode conflictuar com outros canais de comunicações. Para saber mais clique aqui.

Conferência tem uma janela/coluna persistente ótima que pode ser mostrada ou ocultada com as teclas do teclado "\". Utilizadores podem acidentalmente ativar esta funcionalidade, e pode estar novamente ocultados utilizando a tecla "\" (não existe funcionalidade para interface gráfica para o utilizador para poder fechar isto).

Estatísticas
O Phabricator disponibiliza tabelas mostrando que abrindo tarefas por prioridades e tanto por usuário ou projeto. Fora isto, Phabricator não suporta estatística posteriores, métricas, tabelas, relatos, (exemplo: sobre o tempo) ou contudo pode chamá-los, se for incluído via API. Phragile e Phlogiston são opções de ferramentas posteriores de relatos para o Phabricator.

Diffusion


Diffusion, é o navegador do repositório do Phabricator e a ferramenta de gestão do repositório. Eventualmente nós queremos substituir o Gerrit para revisão e gestão do código, e gitblit para mirroring de apenas leitura (read-only) do repositório. Por agora, estamos refletindo - mirroring alguns dos nossos repositórios Git para o Phabricator para fins de demonstração.

Formulários


Phabricator allows some customization of the fields shown for a given task. These are handled via the Forms feature.

Outras links

 * Outro
 * OAuth consumidor prabricator-produção, utilize Special:OAuthManageMyGrants para gerir aplicações conectadas
 * Etiqueta Phabricator