Phabricator/Help/pt

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 melhor compreensão do Phabricator, clique na ligação que segue. Ou continue a ler esta página para aprofundar e iniciar.

O que é o Phabricator e o que faz?

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 perguntará pelo 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, tal como  العَرَبِيةُ ou 中华民族. Um endereço de e-mail também será requerido, 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 Gerir 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 wikitech.wikimedia.org &mdash; também conhecida como conta LDAP ou conta Gerrit — poderá também usar esta conta para aceder. O mesmo nome de utilizador do Phabricator pode ter tanto o MediaWiki.org como LDAP conectado. Este pode ser dados alternância, para o caso de o Wikimedia SUL não estiver a funcionar. Conecte ao seu Wikimedia SUL e a sua conta LDAP para um único nome de utilizador! 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 actualizações e notificações
O Phabricator notifica-o sobre actividades relevantes, incluindo suas próprias acções. Pode ajustar suas preferências de e-mail como lhe convir, recebendo notificações da web apenas por certas actividades 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 actividades em um projecto, pode clicar em  na página do Resumo do projecto.

Criando regras para notificações 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
Existem três formas de criar uma tarefa, dependendo da informação que quiser que contenha:
 * Nova tarefa: Clique no botão  ou na ligação Criar ligação localizada no topo direito. Você receberá um formulário em branco.
 * Uma sub-tarefa para a tarefa existente: Clique na ligação 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", ordenado por actualizações mais recentes.
 * Uma tarefa similar à tarefa por si criada: Depois de criar uma tarefa, uma ligação à Tarefa Similar estará disponível no canto superior direito. Clique nesta ligação para preencher com os mesmos valores os campos Atribuir a, Subscritores, Prioridades, e Projectos.

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

Seleccionando Projectos
De formas a reportar as tarefas em um projecto com a (etiqueta) projecto que utiliza o Phabricator, você precisará apenas de começar a escrever o seu nome no campo Projectos e seleccionar o projecto a partir da lista do projecto correspondente (a lista mostrará apenas cinco projectos correspondentes). Você pode também pesquisar por projectos clicando no ícone da lupa no campo Etiquetas. Você pode adicionar um ou mais projectos no campo Etiquetas. Se estiver em dúvida, pode também deixar isto vazio — triagens cuidarão de tarefas que não têm projectos definidos. Existe uma (longa) lista de projectos disponível. Accione  para pesquisar por projectos. (Esta lista está também disponível em Phabricator/Projectos).

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 Projecto 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 directamente 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 signatário de tarefa, prioridade ou status via e-mail estão disponíveis.

Nota: Se a assinatura de seu e-mail não estiver formatado seguindo os padrões de facto (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 ao link de criação de tarefa genérica.

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

Escrevendo comentários e descrições
O Phabricator permite-o publicar e editar descrições utilizando formatação de texto e inserir 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 em  criará uma ligação para os respectivos perfis dos utilizadores e os subscreverá para a tarefa.
 * Adicionando um número da tarefa como em  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 como em  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 carregada de imagem do modelo, 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 no 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 Create a 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 ficheiros
Existe várias formas de carregar ficheiros: Você pode adicionar um ficheiro (por exemplo uma foto do ecrã) para um comentário ou descrição de tarefa, arrastando com o seu rato. Utilizadores 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 ficheiro, (tal com "123)" que é mostrado depois de um carregamento de ficheiro ser bem sucedido, escrevendo  em um comentário. Isto criará uma ligação ao ficheiro. Para incluir o ficheiro no comentário, feche o em chavetas:. Pré-definidos são incluídos como miniatura. Para mais opções de formatação, visite Referência Remarkup. Se tiver frequentemente de carregar ficheiros e considerar as opções disponíveis actualmente de forma desconfortável, poderá também adicionar uma ligação directa na sua página inicial do painel do texto.

Utilizadores 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 fichero e a seguir diminuir o nível de acesso ao ficheiro (exemplo: ligando-o para uma marca de segurança restrita). Você teria de eliminar o ficheiro e voltar a carregar o ficheiro com permissões de acesso mais restrito. É recomendado que se carregue juntos os ficheiros que terão a mesma mesma marca nível de restrição de acesso (de segurança).

Se precisar de apagar um ficheiro que carregou, abra a previsualização da ligação file/, seleccionad Autorado, selecciona o ficheiro e clique Eliminar ficheiro na barra lateral.

Gestão de projecto em Phabricator
Se mantém o gere um projecto, 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. NOTE: There is a "Edit Related Tasks... > Create Subtask" feature. In addition to setting up the correct parent/subtask relationship, it also caries the CC (subscription) list into the new subtask.
 * Bloqueadores e Sub-tarefas. Uma tarefa (principal) deve simplesmente ser bloqueada por outra (sub)tarefa, representando dependência (ver Phabricator/Project management em como adicionar sub-tarefa).
 * Rasteando. Uma tarefa principal Inactiva bloqueada por várias (sub)tarefas podem estar a rastear uma colecção de (sub)tarefas juntamente com a liberação ou outro período de tempo (ver #Rasteando Tarefas abaixo).
 * Aprovação. Várias tarefas (principais), (como draft team goals) devem ser bloqueadas por uma única (sub)tarefa que representam draft tasks a serem aprovadas, depois estas draft goals são novos objectivos 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 Projecto 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 afecta todo o Projecto que a Tarefa estiver contida. Portanto é impossível ter uma tarefa atribuída por exemplo ao Robin, mas outra Kim em outra. A pessoa designada é mostrada como parte da 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 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.

"Feito"
Cada tarefa tem um campo Status, que inclui o estado Resolvido. Tarefas resolvidas são geralmente ocultadas da Quadro de Trabalho. Quando forem mostradas, elas aparecerão acinzentadas e riscadas. Outros status incluem Aberto e Estagnado.

Note que este status Resolvido é herdado para Tarefa, e deste modo afectará a aparência e comportamento de todo o Projecto (e a área de trabalho) que estiver contido. Este é independente da coluna em que a tarefa estiver, em qualquer área de trabalho dado. Portanto a Tarefa poderia ser Aberta, e poderia estar na coluna FEITO de uma área de trabalho, e contudo na coluna CORRENTE de outra. Isto pode também no (ano seguinte) de uma coluna qualquer em qualquer lugar.

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

Tarefas de Rastreamento
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) Projecto para categorizar este tipo de trabalho.

Note, however, that there are other types of work-less umbrella tasks which do still make sense in Phabricator. Notably, "Release" tasks. An upcoming release could be represented by a Task, which lists as subtasks all the actual work tasks which are targeted for that release. Once the release goes out, it can be resolved. A similar use would be to have a task which represents a teams overall goals for the quarter, and then each goal might (or might not) be a blocking subtask.

Searching for items


Phabricator consists of several applications (task management in "Maniphest" being one of them, and in the future also Diffusion and Differential for code review). The search field in the upper corner allows searching across all these applications.

Using Maniphest (Advanced Search)


Maniphest is a tool which allows users to make detailed queries. Users can refine a query using multiple parameters. Queries can also be saved and managed.

New users will find several saved queries preset inside Maniphest. Clicking on the "Advanced Search" will bring up a new search page.

Click here for a detailed Maniphest walkthrough.

Using Dashboards
Dashboards are specially designed home pages which can display a wide range of custom information. They can be created, managed and shared between users.

Click here for a detailed Dashboard walkthrough.

Batch edits
Phabricator offers the possibility to perform mass/bulk edits for tasks. At the end of any Maniphest search query you will find a "Batch Edit Selected" to edit all the tasks you have selected using Shift-click. Users willing to use this feature need to join the Triagers group.

Personal lists of items
The "Flag For Later" functionality offers marking objects (like tasks or revisions) which "you want to remember to look at later". Eight flag colors are available. Flags are personal and private so your lists cannot be shared with others. Your flagged objects are listed on flag. They can be searched by color or object type, in contrast to tokens.

Criando um projecto


In Phabricator projects are tags, tags are projects. Hierarchy via sub-projects is available since February 2016. Tasks can be assigned to more than one project, and they can also be submitted without assigning them to any project.

Quando é que você precisa de um projecto
In general, you need a project...
 * when you have an established team running one or several projects (start here, ask more only when you need more)
 * when you need a workboard (i.e. a sprint)
 * when you need a tag or keyword to organize a type of task that can be part of any project (for example "Accessibility")

Requesting a new project
See Phabricator/Requesting a new project.

Restricting access to tasks
Please see Phabricator/Security for a general overview and for the "Security" dropdown option in tasks. See Phabricator/Creating and renaming projects for default project settings (and using Spaces).

Displaying and using a Space


''Spaces (upstream documentation) allow restricting access to groups of objects (like tasks) to members of a specific group only. See Restricting access via Space policies for setting up.''

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.



In Maniphest's task view, the Space will also be displayed in front of the task summary. You can batch-edit tasks to move them to a different Space.

Note that you will still have to associate the corresponding "public" project (if existing) to a task to make a task in a restricted Space (which you have access to) to show up in search queries and the workboard of the project. The "public" project could be automatically added via requesting a global Herald rule.

MediaWiki templates and links

 * You can link to Phabricator tasks from wiki pages using  and its shorter version , for instance   generates example.
 * Template:Tracked has been updated to include links to Phabricator objects — see at the right how  is rendered.
 * Template:Phabricator is also available;  generates.

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

Using Conpherence
Conpherence is a Phabricator application that enables private conversations between two or more users, similar to instant messaging and private chat rooms. No team is known to use this. It may conflict with other communication channels. To learn more click here.

Conpherence has an optional persistent window/column that can be shown and hidden with the keyboard key "\". Users may accidentally activate this feature, and it can only be hidden again by using the "\" key (there is no graphical UI feature to close it).

Estatísticas
O Phabricator disponibiliza tabelas mostrando que abrindo tarefas por prioridades e tanto por utilizador ou projecto. 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 Phragiston são 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 reflectindo - mirroring de apenas leitura (read-only) do repositório. Por agora, estamos reflectindo alguns dos nossos repositórios para o Phabricator para fins de demonstração.

Outras ligações

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