Page MenuHomePhabricator

Explore phabricator search features and report on suggested uses
Closed, ResolvedPublic

Description

As a user I would like to know best practices for phabicator search tools so that I can perform data analysis on tasks and bug.

Acceptance criteria:
Create a rough userguide to phabricator search and "Maniphest"
Test and report on possible best practices

Event Timeline

DStrine claimed this task.
DStrine raised the priority of this task from to Needs Triage.
DStrine updated the task description. (Show Details)
DStrine added a project: Team-Practices.
DStrine subscribed.

Search documentation is available. If that does not sufficiently cover "performing data analysis on tasks and bug" (which I assume): Please elaborate.

The search documentation for phabricator is extremely limited and only covers the basic search in the upper right UI.

@Aklapper the search page you linked is related to the simple search features. Also the video on Maniphest is outdated.

I have created 2 detailed descriptions of Maniphest searches and Dashboards here:

https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Dashboards
https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Maniphest

They are subpages of the Phabricator tips page:
https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips

@Aklapper the search page you linked is related to the simple search features.

Errrm, but why does it mention the term "Advanced Search" several times then?

Also the video on Maniphest is outdated.

That's why it explicitly says "outdated"... anybody can provide an updated version.

I have created 2 detailed descriptions of Maniphest searches and Dashboards here:

https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Dashboards
https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Maniphest

These pages are great and I hope that you have plans to integrate those pages into the existing canonical documentation at https://www.mediawiki.org/wiki/Phabricator/Help ?

@Aklapper the search page you linked is related to the simple search features.

Errrm, but why does it mention the term "Advanced Search" several times then?

If you click on the globe icon beside the search field in the upper right (of all phabricator screens) you get options for an "advanced search" which is very limited compared to Maniphest searches. Also the documentation under the globe icon is only related to the version of advanced search under the globe.

The external maniphest pages I can find are extremely limited. When inside Maniphest the only search option is called advanced. It also mixes the terms "Search" and "Query" freely within the same UI. I could keep going with this list...

I cannot account for the mixed terminology and gaps in Phabricator documentation. I merely attempted to make a highly visual breakdown in plain english.

Also the video on Maniphest is outdated.

That's why it explicitly says "outdated"... anybody can provide an updated version.

see next phab task below.

I have created 2 detailed descriptions of Maniphest searches and Dashboards here:

https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Dashboards
https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips/Maniphest

These pages are great and I hope that you have plans to integrate those pages into the existing canonical documentation at https://www.mediawiki.org/wiki/Phabricator/Help ?

Is it canonical? I was directed to the page below in my first few days here:
https://www.mediawiki.org/wiki/Team_Practices_Group/Phabricator_tips

I have already volunteered to work on combining (or at least cross referencing) phabricator pages. I hear rumors of several pages existing on office wiki and collab too. The only thing I know at the moment is that there are mixed signals and outdated information in several places.

I was planning to ask around a lot before I changed anything. If you are interested in this too, maybe we could meet and chat?
My task for next week:
https://phabricator.wikimedia.org/T98521

DStrine triaged this task as Medium priority.

assigned to @JAufrecht for review

As discussed offline, the Dashboard page benefited from some specific examples of usage. I like it; I didn't know I could do dashboards before.

The Search help tips also look good; I added some minor questions/suggestions to the Talk Page.

I'm not able to access the example dashboard mentioned in the Dashboard article, https://phabricator.wikimedia.org/dashboard/view/120/:

Access Denied: Restricted Panel
You do not have permission to view this object.
Users with the "Can View" capability:

Members of the project "WMF FR" can take this action.

I don't see any way to add an Advanced Query to my Dashboard. Use Case: show all tasks assigned to me and closed, in reverse order of date changed or closed. Is there any way to do this with Dashboards, or can you only add Panels, which seem to be limited queries?

Also, you could add something about how to set a Dashboard as your home page, or how to set a dashboard as the home page for a project (not sure if that's possible - if not, would be a nice feature).

@JAufrecht
thanks for your comments. I think some of your issues are due to some specific FR-tech configuration. It seems that if you reference restricted tasks or projects on a dash, the whole dash will fail for users without the right access level. I will have to totally remake the example dash I also have to note those sharing issues.

I'll address most of this shortly.

you could add something about how to set a Dashboard as your home page

Also see https://www.mediawiki.org/wiki/Phabricator/Help#Creating_your_dashboard for existing documentation.