Phabricator/Ajuda

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Phabricator/Help and the translation is 46% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎italiano • ‎kurdî • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎svenska • ‎русский • ‎українська • ‎العربية • ‎سنڌي • ‎پښتو • ‎हिन्दी • ‎বাংলা • ‎ଓଡ଼ିଆ • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

Estimado utilizador do Phabricator, se tiver perguntas faça-as na página de discussão. Melhoramos a nossa documentação com base nos comentários recebidos.

Se quiser testar o Phabricator, deve utilizar a instância do Labs.

Para uma descrição geral do Phabricator e do que este pode fazer, veja esta apresentação. Para começar de imediato, continue a ler esta página.

Criar a sua conta

You can connect your new Phabricator account either with your global Wikimedia wiki account, or with your Wikimedia developer account. In both cases, no separate password is needed.

With your global wiki account

Como criar a sua conta no Phabricator com a autenticação unificada da Wikimedia ...
Como preencher o seu perfil do Phabricator.
  • Primeiro, certifique-se de que está autenticado na Wikimedia.
    • Se ainda não tiver uma conta na Wikimedia, registe-se.
  • Vá à página de entrada no Phabricator (quando não estiver autenticado, esta hiperligação aparece como uma seta para uma porta, no cimo à direita).
  • Clique no botão do girassol que diz "«Aceda ou Registe-se - MediaWiki».
  • Ser-lhe-á pedido pela MediaWiki.org para aprovar a ligação.
  • O Phabricator irá pedir-lhe um nome de utilizador. Em caso de dúvidas, use o seu nome de utilizador da Wikimedia, mas note que o nome de utilizador do Phabricator não pode conter caracteres que não sejam do alfabeto latino, tal como العَرَبِيةُ ou 中华民族, nem incluir espaços (use sublinhados «_»). Também será necessário um endereço válido de correio eletrónico para verificação, que não será mostrado aos outros utilizadores.
  • Clique Gerir na barra de navegação à esquerda.
  • Clique Editar Perfil e defina o seu «Também Conhecido Por» (por exemplo, com o seu nome completo) para poder ser localizado mais facilmente.

With your Wikimedia Developer account

... ou com a sua conta de programador da Wikimedia.
Avançado
Se tiver uma conta de desenvolvimento da Wikimedia — também conhecida como conta LDAP, conta Gerrit ou conta wikitech — também pode usá-la para iniciar a sessão. O mesmo nome de utilizador do Phabricator pode estar ligado tanto à MediaWiki.org como ao LDAP. Esta redundância pode servir de ligação de reserva, para a improvável eventualidade de a autenticação unificada da Wikimedia não estar a funcionar.

Ligue as suas contas Wikimedia SUL e LDAP a um único nome de utilizador do Phabricator! Se não o fizer, criará duas contas separadas no Phabricator.

Multi-factor authentication

Nós não encorajamos a utilização da autenticação de vários fatores no Wikimedia Phabricator. Se ainda assim pretender utilizá-la, leia primeiro as orientações e requisitos da autenticação multi-factores.

Troubleshooting

  • If you find your Phabricator account disabled, please add a note on Talk:Phabricator/Help.
  • If you get an "Email address already taken" error when you try to create a Phabricator account via "Login or Register - MediaWiki" you probably already registered a Phabricator account connected to your Wikimedia Developer account. You will have to log into Phabricator via your Developer account. Use wikitech:Special:PasswordReset if you have forgotten your Developer account password.
  • To change your Phabricator user name for some reason, please add a note on Talk:Phabricator/Help and include a link to your Phabricator profile.
  • To change the global wiki account or developer account that is associated to your Phabricator account:
    • Note that your Phabricator account must be associated to either a global wiki account or a developer account at all times.
    • If you want to change your global wiki account that is connected to your Phabricator account: Log into Phabricator via your developer account that is also connected to your Phabricator account. Then remove your old global wiki account and connect your new global wiki account to your Phabricator account. (If your Phabricator account is only connected to your global wiki account but not yet also to a developer account, connect a developer account to your Phabricator account first.)
    • If you want to change your developer account that is connected to your Phabricator account: Log into Phabricator via your global wiki account that is also connected to your Phabricator account. Then remove your old developer account and connect your new developer account to your Phabricator account. If your Phabricator account is only associated to your global wiki account but not yet also to a developer account, connect a developer account to your Phabricator account first.)

Reivindicar as suas contas anteriores no Bugzilla e RT

Siga esta hiperligação.

Receber atualizações e notificações

Subscrever uma única tarefa
Vigiar um projeto para receber as suas notificações

O Phabricator notifica-o das atividades relevantes, incluindo das suas próprias ações. Pode ajustar as suas preferências de correio eletrónico como lhe convier, para receber notificações só de certas atividades ou não as receber de todo.

O Phabricator oferece várias formas de especificar as notificações que desejar receber.

  • Se estiver interessado num único objeto (uma tarefa, um protótipo, etc.) clique apenas em Subscrever na respetiva página. Adicionar um comentário causa a subscrição automática do objeto.
  • Se estiver interessado em todas as atividades de um projeto, pode clicar Vigiar projeto na página de resumo desse projeto. Existe informação adicional no guia do utilizador Projetos, secção «Vigiar projetos».

See Phabricator/Help/Managing mail for reducing the amount of mail notifications and about filtering mail notifications.

Troubleshooting

If you receive unexpected mail notifications for a task:

Criar regras de anúncio de notificações

Siga esta hiperligação para saber como criar regras de notificação personalizadas no Wikimedia Phabricator. Este opção é mais avançada e pode ser difícil de usar.

Criar uma tarefa

Formas de criar uma tarefa.
Como editar uma tarefa já criada.

Há várias formas de criar uma tarefa, dependendo da informação que quer que ela contenha:

  • Uma tarefa nova: clique o botão com uma estrela, na barra de navegação no topo, à direita. A partir do menu descendente, escolha Criar tarefa. Obterá um formulário em branco.
  • Um problema de segurança: clique o botão com uma estrela, na barra de navegação no topo, à direita. A partir do menu descendente, escolha «Reportar problema de segurança». Obterá um formulário pré-etiquetado com Segurança e com uma hiperligação para instruções especiais para defeitos de segurança.
  • Uma subtarefa de uma tarefa existente: clique Editar tarefas relacionadas… > Criar subtarefa na coluna direita da tarefa atual. A dependência entre ambas as tarefas será definida, e alguns dos valores da tarefa principal serão transportados por omissão (Atribuída a, Subscritores, Prioridade, Projetos). As subtarefas são listadas na tarefa mãe, na secção «Grafo da tarefa», por ordem decrescente da data de atualização.

Preencha o formulário, deixando inalterados os campos de cujo significado esteja incerto.

Phabricator supports some formatting in text areas. See #Formatting and markup.

Use the live preview at the end of the page to check whether your text looks as you expect.

Selecionar projetos

Para relacionar uma tarefa com um projeto (uma etiqueta de projeto) que usa o Phabricator, só precisa de começar a escrever o nome do mesmo no campo Etiquetas e selecioná-lo da lista de projetos correspondentes (a lista só mostra cinco projetos correspondentes). Também pode pesquisar projetos e ler descrições breves dos mesmos clicando no ícone da lupa no campo Etiquetas. Pode acrescentar um ou mais projetos ao campo Etiquetas. Se estiver incerto, também pode deixar o campo vazio — o processo de triagem endereçará as tarefas que não tenham projeto definido. Está disponível uma (longa) lista de projetos. Clique Editar consulta para pesquisar projetos (esta lista também está disponível em Phabricator/Projetos).

Definir a prioridade da tarefa

A prioridade deve geralmente ser definida pelos administradores do produto, pelos programadores de manutenção ou desenvolvimento que pretendam trabalhar na tarefa, por um vigilante de erros ou pelos membros experientes da comunidade, e não pelo autor do relatório do defeito nem por observadores externos. Para mais detalhes, consulte gestão de projetos no Phabricator.

Usar o correio eletrónico

Também pode criar tarefas enviando uma mensagem de correio eletrónico para task@phabricator.wikimedia.org. O assunto será usado como título da tarefa, o texto será diretamente usado e os anexos serão incluídos na tarefa. Para definir o projeto, adicione o comando correspondente !projects e a respetiva hashtag no início do texto, por exemplo: !projects #mediawiki-core. Estão disponíveis comandos adicionais para definir por correio eletrónico o responsável pela tarefa, a prioridade ou o estado.

Nota: se a assinatura do seu correio eletrónico não estiver formatada de acordo com o padrão vigente (incluindo «-- » para separá-la do corpo do texto), ela também será publicada. Encorajamos a remoção de informações privadas da sua assinatura à primeira tentativa, para evitar dissabores.

Passar certos valores no URL de criação de tarefa

A hiperligação Reportar um defeito no Phabricator pode passar muitos valores através de parâmetros de URL adicionados à hiperligação genérica para criação de uma tarefa.

Esta é uma funcionalidade muito avançada. Mais informação aqui.

Commenting and editing a task

Para responder, também precisa de ter uma conta, que é basicamente o seu nome na Wikimedia.

Pode fazer várias coisas ao mesmo tempo que faz um comentário.

O Phabricator permite publicar e editar comentários e descrições usando formatação do texto e inserindo imagens ou outros ficheiros; consulte Carregar e anexar ficheiros. Pode usar a barra de ferramentas no cimo da área de introdução de texto e pode utilizar o Reformatar do Phabricator.

Use the live preview at the end of the page to check whether your text looks as you expect.

To edit the description of a task, select "Edit Task" in the side bar.

To close a task as a duplicate of another task, select "Edit Related Tasks... > Close As Duplicate" in the side bar.

Formatting and markup

Como formatar o texto que escreve num comentário e como usar listas e cabeçalhos.

Phabricator supports some formatting in text areas.

Note que a notação de formatação do Phabricator é diferente da notação do MediaWiki. A instância do Phabricator a montante aloja uma Referência de reformatação para a notação que é própria do Phabricator.

Ao fundo da página tem uma antevisão em tempo real que permite verificar se o seu texto corresponde ao esperado. Entre as notações utilizadas frequentemente inclui-se:

  • Mencionar utilizadores, com a forma @nome_de_utilizador, cria uma hiperligação para os respetivos perfis e torna-os subscritores da tarefa.
  • Adicionar um número de tarefa, com a forma T123, cria uma hiperligação para a tarefa incluindo uma janela flutuante. {T123} insere o título da tarefa no seu texto.
  • Adicionar um nome de projeto, com a forma #Project, cria uma hiperligação para a página principal do projeto.
  • Se quiser citar um texto, pode simplesmente adicionar «>» no início. Se quer responder a um comentário incluindo-o como uma citação, clique a seta à direita do fim do comentário a que pretende responder.
  • Se quiser mostrar um ficheiro de imagem carregado, por exemplo, como M123, em linha no seu comentário, escreva {M123}.
  • Se quiser criar uma hiperligação externa, por exemplo, [https://www.mediawiki.org example] em notação de texto wiki, use [[ https://www.mediawiki.org | example ]] incluindo os espaços em branco no Phabricator.
  • Se quiser adicionar um endereço da Internet (um URL) a um comentário, por exemplo para fornecer um caso de teste, é altamente recomendado que copie e insira o endereço completo da barra de endereço do navegador, por exemplo, https://www.mediawiki.org/wiki/Project:Support_desk em vez de mw:Project:Support desk. Os prefixos interwikis como mw: não são suportados no Phabricator e a maioria das personalizações que o Bugzilla tinha também não são; as alterações do Gerrit também devem ser inseridas como endereços completos.
  • Se quiser inserir linhas de código, adicione uma linha com três acentos graves antes e depois do código: ```, ou crie uma Inserção e ligue à Inserção a partir da tarefa.

Carregar e anexar ficheiros

Como carregar ficheiros.

Há várias formas de carregar ficheiros: pode adicionar um ficheiro (por exemplo, uma foto do ecrã) a um comentário ou à descrição de uma tarefa, arrastando-o com o rato. Os utilizadores também podem copiar e inserir imagens usando a área de transferência dos seus sistemas.

Se esta não existir no seu sistema, pode usar phabricator:file/upload e referir o número de ficheiro (como «123») que é mostrado depois do carregamento do ficheiro, escrevendo F123 num comentário. Isto criará uma hiperligação para o ficheiro. Para incluir o ficheiro no comentário, coloque o identificador entre chavetas: {F123}. Por omissão, o ficheiro é incluído na forma de miniatura.

Para mais opções de formatação, visite [$url Referência de reformatação].

Se tem de carregar ficheiros com frequência e considera as opções disponíveis atualmente desconfortáveis, também pode adicionar um painel de texto à sua página inicial com uma hiperligação direta.

Note que não pode carregar um ficheiro e depois reduzir o nível de acesso do mesmo (por exemplo, ligando-o a um objeto de acesso restrito). Teria de eliminar o ficheiro e recarregá-lo com níveis de acesso mais restritos. É recomendado que se carregue os ficheiros que devem ter acesso restrito em conjunto com a criação do respetivo objeto de acesso restrito. Adicionalmente, note que qualquer pessoa que tenha o URL completo do ficheiro pode descarregá-lo ou partilhar a hiperligação com outras pessoas. Não existe nenhum processo de autenticação a proteger o acesso aos ficheiros. No Phabricator, os ficheiros dependem inteiramente da segurança por obscurantismo; adivinhar o URL (pseudo-aleatório) de qualquer ficheiro em particular seria muito difícil. Se precisar de mais proteção para ficheiros particularmente sensíveis, então deverá considerar uma alternativa mais segura.

Se alguma vez precisar de apagar um ficheiro que carregou, abra a lista dos ficheiros de sua autoria, selecione o ficheiro e clique Eliminar ficheiro na barra lateral.

Gestão de projetos no Phabricator

Se mantém ou gere um projeto, siga esta hiperligação para obter mais detalhes, por favor.

Tarefas mãe e subtarefas

As tarefas podem ser tarefas mãe ou subtarefas de qualquer número de outras tarefas. Estas relações podem ser definidas em Editar tarefas relacionadas.... Esta funcionalidade pode ser usada para as seguintes:

  • Bloqueadoras e subtarefas. Uma tarefa (mãe) pode ser simplesmente bloqueada por outra (sub)tarefa, que representa uma dependência (ver Special:MyLanguage/Phabricator/Project management#Tasks that cannot be worked on yet para saber como adicionar uma subtarefa).
  • Rastreio. Uma tarefa (mãe) «inactiva» bloqueada por várias (sub)tarefas pode estar a rastrear um conjunto de (sub)tarefas associadas a uma versão do programa ou a um outro período de tempo. Note que o termo «rastrear» tem aqui um significado diferente da etiqueta descontinuada #Tracking do Phabricator.
  • Aprovação. Várias tarefas (mãe) (como os rascunhos dos objetivos de uma equipa) podem ser bloqueadas por uma única (sub)tarefa que representa as tarefas preliminares em processo de aprovação, após a qual os objetivos preliminares passam a ser objetivos reais.

NOTA: Existe uma funcionalidade «Editar tarefas relacionadas... > Criar subtarefa". Para além de definir corretamente a relação entre a tarefa mãe e a subtarefa, esta funcionalidade também transporta para a subtarefa a lista de subscritores.

Atribuição de prioridade

See Phabricator/Project management#Setting task priorities

Atribuição

See Phabricator/Project management#Assigning tasks

Tarefas de rastreio

Este termo veio do Bugzilla, onde tinha um significado específico: uma tarefa que estava bloqueada por outras, mas que em si mesma não representava nenhum trabalho nem estava ligada a uma versão ou data específica. Um exemplo disto poderia ser uma tarefa chamada Limpar a documentação, que tenha uma variedade de subtarefas, cada uma das quais descreve um trabalho específico a ser feito. Estas tarefas de Rastreio tinham a tendência de ficar em aberto por muito tempo (ou para sempre), porque à medida que as suas subtarefas eram resolvidas outras novas eram criadas. No Phabricator, seria melhor criar um projeto (etiqueta) para categorizar este tipo de trabalho.

Note, contudo, que existem outros tipos de tarefas coordenadoras que continuam a fazer sentido no Phabricator. Em especial, as tarefas «Versão». Uma versão próxima pode ser representada por uma tarefa, que lista como subtarefas todas as tarefas respeitantes aos trabalhos que estão planeados para essa versão. Depois da nova versão ter sido publicada, pode ser marcada como resolvida. Um uso semelhante seria ter uma tarefa que representa os objetivos globais de uma equipa para um trimestre, e depois cada objetivo pode (ou não) vir a ser uma subtarefa bloqueante.

Pesquisar coisas

Search context (global vs advanced)

Usar o campo básico de pesquisa do Phabricator no canto superior direito.

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

Usar a pesquisa avançada do Maniphest

There are 2 different search forms:

  • The global search at https://phabricator.wikimedia.org/search/query/advanced/, confusingly labeled "advanced search." This one is fairly simple. It is in the upper right corner. By default, it searches across all applications and hence all types of documents (open tasks, closed tasks, code commits, etc…). You can change the default context using the the arrow menu to the left of the search bar. For example, select "Open Tasks" to only show results in open tasks from the Maniphest issue tracker. Or select "Current Application" to search Maniphest in Maniphest, Diffusion in Diffusion etc. Tags specified are unioned (OR'd).
  • Advanced, application specific search, for example at https://phabricator.wikimedia.org/maniphest/query/advanced/ for Maniphest. This one has more fields, and auto-completion that includes "Not in:..." (equivalent to NOT) and "In any:..." (equivalent to OR) (for example, type "echo" in the "Tags" field). There is also an advanced search for most other applications (e.g. phab:file/query/advanced for Files). To only search for tasks / bug reports, use the Maniphest advanced search. Tags specified are intersected (AND'd).

Inside Maniphest, custom, saved searches and advanced search options are listed in the navigation bar on the left.

Search terms

Special care needs to be put in choosing correct search terms.

Some locally-valid properties for the "Query" field:

  • Case insensitive: Edit is the same as eDIt
  • phrase search works: "fatal error"
  • basic tokenization is performed, e.g. to strip punctuation
  • Stemming is performed: "edited" is also found when searching for edit. However, "edited" does not match edit as quoted text does not stem.
  • Substring search is supported: ~amp matches example, but amp does not.
  • ~"an examp" matches an example as quoted and substring-operator text uses substring search.
  • Boolean queries to exclude certain terms are possible by using the - symbol before the unwanted term. E.g. use -non fatal error to exclude "non-fatal" errors from results.
  • To only search in a task title but not in the task description or comments, use title:quick ferret which is the same as title:quick title:ferret. To search for one term in the task title and other terms anywhere in a task, use ferret title:quick or title:quick all:ferret. See https://secure.phabricator.com/book/phabricator/article/search/ for more information.

The advanced search forms are not explicit about the logic but in general use AND between different fields. You can exclude specific projects from the results by entering not(projectname) (equivalent to NOT) and combine several projects via any(projectname) (equivalent to OR) via the auto-completion suggestions. There's a limit of 5 items in the maniphest autocomplete. To increase this limit, see these userscripts for Chrome and for Firefox.

Alternatives ways to find something

If you don't remember the exact words used in an item you are looking for you can follow one of these paths:

  • use the activity feed and edit the query to be restricted to certain projects or timeframes
  • use the activity feed to list all actions that you performed in a certain timeframe at phab:feed/query/EW2FwdAi.Kfz/
  • use an external search engine;
  • remove all search terms, refine the search only by project etc. and then scan all the possible results manually or use Ctrl+F to search specific strings (this might require setting "Page Size" to a high value to display more than only 100 results);
  • file a new task, mentioning that a past report exists as well, and wait for someone to merge the new report to the old.

Selecting Dates and Date Ranges

This is only available in the Advanced Search.

Using the Date fields like "Created After" and "Created Before" allow entering absolute and relative dates. Note that Maniphest uses UTC.

To get a list of tasks which were created in the last 24 hours, set the "Created After" field to "-24 hours" or "-1 day". Note that "Updated Before" actually means "Last updated before" and that absolute date values like "2014-11-26" refer to UTC time while your time zone setting might be different. The "Updated After" and "Updated Before" fields return any and all changes to a task. For example, when a task is moved to another column in a board it registers as "updated". This may add noise to your search results.

Examples of how Maniphest interprets searches:

  • "02/25/2015" - interpreted as "00:01 on February 25th, 2015" (UTC)
  • "5 days ago" - interpreted as "00:01 on the fourth calendar day before today" (UTC)
  • "2:45 AM 5 days ago" - interpreted as "02:45 on the fourth calendar day before today" (UTC)

The "X days ago" range can be confusing. Phabricator interprets today as part of any data set. Even if it is 12:30 UTC, Phabricator will interpret that as a potential day in the range.

Saving and Managing Searches/Queries

Queries can be saved and managed inside Maniphest.

Maniphest offers links to some predefined search queries in the navigation bar on the left. For example, click authored to get a list of tasks that you have created.

Search query addresses (URL) are stable so you can save and reuse them. You can share the address in your web browser's address bar with other people, e.g. via posting the link on a wikipage.

If you want to save a search, select the "Save Query" button at the bottom of the Advanced Search UI.

When looking at the navigation bar on the left in Maniphest, click on the "Edit Queries…" link. You will see a list of your saved queries. All users have a default set which can be deleted in this UI.

Some options in this UI:

  • Use the line elements on the left to drag queries up and down in the list.
  • The "x" will permanently delete a Query.
  • The Pencil icon allows a user to edit the name of a query
  • Clicking on the name of a Query will bring up the search options and results of that query

Once you save a query, you cannot change its parameters, but you can change its name. To edit a query, click on it's name, change parameters and save it as a new query. Also, Phabricator allows users to save multiple queries with the same name.

To make the user name dynamic (e.g. for "Tasks assigned to the person running this query") in searches that you'd like to share with others, set "Current viewer".

Note that some common queries are also available in the "Activity" tabs on the Phabricator frontpage.

Finding the Maniphest task corresponding to a Bugzilla bug number

This is only available in the Advanced Search.

All Phabricator tasks migrated in 2014 from Bugzilla have a Reference field that contains a value "bz" followed by the number of the equivalent report in Bugzilla. If you want to search the task corresponding to a specific Bugzilla report, use the Reference field in the advanced search or just add 2000.


Funcionalidades avançadas

Usar painéis

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 utilizadores.

Clique aqui para ver uma descrição detalhada dos painéis do Maniphest.

Edições em massa

O Phabricator oferece a possibilidade de executar edições em massa de tarefas. No fim de qualquer consulta de pesquisa no Maniphest encontrará «Edição em Massa Selecionada» para editar todas as tarefas que tiver selecionado usando o Shift-Clique. Os utilizadores que pretendam utilizar esta funcionalidade precisam de se juntar ao grupo de triagem.

As edições em massa podem ser revertidas anotando o identificador do «Processo de edições em massa» que é gerado no início de uma edição em massa. Pode aceder-se a este identificador clicando «Detalhes» antes ou depois da execução. Na página seguinte, haverá uma entrada «Continuar» no menu à direita, que gera uma consulta de pesquisa no Maniphest de todas as tarefas afetadas.

Preferidos

O menu da estrela na barra de navegação ao topo pode ser personalizado com hiperligações para os seus formulários e operações preferidos. Consulte as instruções do Menu do perfil para mais informações.

Listas pessoais de sinalizadores

A funcionalidade «Sinalizar para depois» permite marcar objetos (como tarefas ou revisões) que gostaria de executar posteriormente. Estão disponíveis oito cores de sinalização. Os sinalizadores são pessoais e privados, portanto as suas listas não podem ser partilhadas com outros utilizadores. Os seus objetos sinalizados estão listados em sinalização. Estes podem ser pesquisados por cor ou tipo de objeto, em contraste com os símbolos.

Criar um projeto

Apresentação que ilustra como pedir um projeto

No Phabricator, os projetos são etiquetas e as etiquetas são projetos. Está disponível de fevereiro de 2016 a possibilidades de hierarquizar projetos usando subprojetos.[1] Podem ser atribuídas tarefas a mais de um projeto, e estas também podem ser enviadas sem atribuí-las a qualquer projeto.

Quando é preciso um projeto?

Em geral, precisa de um projeto...

  • Quando tem uma equipa estabelecida a executar um ou mais projetos (comece por aqui, peça mais só quando precisar de mais).
  • Quando precisa de um quadro de trabalhos (isto é, de um sprint).
  • Quando precisa de uma etiqueta ou palavra-chave para organizar um tipo de tarefa que pode ser parte de qualquer projeto (por exemplo «Acessibilidade»).

Pedir um projeto novo

Ver Phabricator/Pedir um projeto novo.

Restringir o acesso a tarefas

Access to a specific task can be changed via "Edit Task" and then changing the "Visible To" field to something else than "Public".

Note that tasks filed as Security issues are not publicly visible.

Para obter uma perspetiva geral e o formulário de criação de tarefas dedicadas consulte Phabricator/Segurança, por favor. Consulte Phabricator/Criar e alterar o nome de projetos#Normas para conhecer as configurações predefinidas (e a utilização de espaços).

Apresentar e usar um espaço

Os espaços (documentação a montante) permitem restringir o acesso a grupos de objetos (como tarefas) permitindo só o acesso de membros de um grupo específico. Consulte Phabricator/Criar e alterar o nome de projetos#Restringir o acesso através das normas de espaços para aprender a configurá-los.

Se poder aceder a pelo menos dois espaços, vê um menu descendente adicional «Espaços» abaixo de «Visível para» ao criar e editar um objeto. Os utilizadores com acesso a apenas um espaço não verão este controlo.

Na vista de tarefa do Maniphest, o espaço também é mostrado em frente do resumo da tarefa. Pode editar em massa as tarefas para movê-las para um espaço diferente.

Note que continuará a ter de associar o projeto «público» correspondente (se este existir) a uma tarefa, para fazer com que uma tarefa num espaço restrito (à qual tem acesso) apareça nas consultas de pesquisa e no quadro de trabalhos do projeto. O projeto «público» pode ser automaticamente adicionado pedindo uma regra geral de notificação.

Ao criar tarefas em espaços, use a opção «Criar tarefa avançada» do submenu «Criar tarefa». Esta opção apresentará um menu descendente adicional «Espaços» abaixo de «Visível para» na interface de criação de tarefas, que lhe permite definir a visibilidade como o espaço para o qual esta tarefa deve ser visível.

Se, pelo contrário, criar uma tarefa através da opção «Criar tarefa simples» do menu descendente «Criar tarefa», então, depois de criá-la, terá de editar a tarefa para restringir a visibilidade, permitindo-a só aos membros do espaço. Antes desta edição, a tarefa será visível por qualquer pessoa e as notificações relacionadas com a sua tarefa poderão ter sido enviadas aos canais IRC públicos registados e a outros indivíduos subscritos.

Hiperligações e predefinições do MediaWiki

  • Pode criar hiperligações para tarefas do Phabricator nas páginas de uma wiki utilizando phabricator: e a versão mais reduzida phab:, por exemplo [[phab:T454|exemplo]] gera exemplo.
  • Template:Tracked foi atualizado para incluir hiperligações para os objectos do Phabricator — veja à direita como {{Tracked|T177|resolvido}} é mostrado.
  • Template:Phabricator também está disponível; {{Phabricator|T176}} gera task T176.

As hiperligações e predefinições existentes do Bugzilla continuarão a funcionar, porque continuam a apontar para bugzilla.wikimedia.org que as redireciona para a respetiva tarefa convertida no Phabricator.

Usar a Conpherence

A Conpherence é uma aplicação do Phabricator que permite conversação privada entre dois ou mais utilizadores, semelhante às aplicações de mensagens instantâneas com salas de conversação privadas. Não se conhece nenhuma equipa que a utilize. Pode entrar em conflito com outros canais de comunicação. Para saber mais, clique aqui.

A Conpherence tem uma janela/coluna persistente opcional que pode ser mostrada ou ocultada com a tecla «\». Os utilizadores podem ativar esta funcionalidade por acidente, e ela só pode ser novamente ocultada usando a tecla «\» (não existe funcionalidade na interface gráfica para fechá-la).

Estatísticas

O Phabricator disponibiliza tabelas que mostram as tarefas abertas, listadas por prioridade e por utilizador ou projeto. Quanto a tudo o resto, o Phabricator não suporta quaisquer outras estatísticas, métricas, tabelas, relatórios nem o que queira chamar-lhes, quer de raiz quer através de uma API.

[2]

Phragile e Phlogiston são duas opções de ferramentas para ter relatórios adicionais do Phabricator.

Diffusion

Diffusion é o navegador do repositório do Phabricator[3] e a ferramenta de gestão do repositório. Pretendemos substituir eventualmente o Gerrit para revisão e gestão do código, e o gitblit para réplicas só de leitura do repositório. Neste momento, estamos a replicar alguns dos nossos repositórios do Git no Phabricator para fins de demonstração.

To request and set up a new code repository, see Gerrit/New repositories/Requests.

Formulários

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

API (Conduit)

Conduit is the name of the web API. https://phabricator.wikimedia.org/conduit/ offers some explanation and examples. See the Conduit upstream documentation. Also see Phabricator/Bots.

Outras hiperligações

  1. T3670 (subprojects), na instância a montante do Phabricator
  2. T1562 (estatísticas), na instância a montante do Phabricator
  3. Guia de utilizador do navegador do repositório Diffusion, na instância a montante to Phabricator