Differential D25007 Diff 23 src/docs/user/userguide/search.diviner

Changeset View

Standalone View

src/docs/user/userguide/search.diviner

	@title Search User Guide			@title Search User Guide
	@group userguide			@group userguide

	Introduction to searching for documents in Phabricator.			Introduction to searching for documents in Phorge.

	Overview			Overview
	========			========

	Phabricator has two major ways to search for documents and objects (like tasks,			Phorge has two major ways to search for documents and objects (like tasks,
	code reviews, users, wiki documents, and so on): global search and			code reviews, users, wiki documents, and so on): global search and
	application search.			application search.

	Global search allows you to search across multiple document types at once,			Global search allows you to search across multiple document types at once,
	but has fewer options for refining a search. It's a good general-purpose			but has fewer options for refining a search. It's a good general-purpose
	search, and helpful if you're searching for a text string.			search, and helpful if you're searching for a text string.

	Application search allows you to search within an application (like			Application search allows you to search within an application (like
	Show All 11 Lines

	Global search allows you to search across multiple document types at once.			Global search allows you to search across multiple document types at once.
	You can access global search by entering a search query in the main menu bar.			You can access global search by entering a search query in the main menu bar.

	By default, global search queries search all document types: for example, they			By default, global search queries search all document types: for example, they
	will find matching tasks, commits, wiki documents, users, etc. You can use the			will find matching tasks, commits, wiki documents, users, etc. You can use the
	dropdown to the left of the search box to select a different search scope.			dropdown to the left of the search box to select a different search scope.

	If you choose the Current Application scope, Phabricator will search for			If you choose the Current Application scope, Phorge will search for
	open documents in the current application. For example, if you're in Maniphest			open documents in the current application. For example, if you're in Maniphest
	and run a search, you'll get matching tasks. If you're in Phriction and run a			and run a search, you'll get matching tasks. If you're in Phriction and run a
	search, you'll get matching wiki documents.			search, you'll get matching wiki documents.

	Some pages (like the 404 page) don't belong to an application, or belong to an			Some pages (like the 404 page) don't belong to an application, or belong to an
	application which doesn't have any searchable documents. In these cases,			application which doesn't have any searchable documents. In these cases,
	Phabricator will search all documents.			Phorge will search all documents.

	To quickly jump to an object like a task, enter the object's ID in the			To quickly jump to an object like a task, enter the object's ID in the
	global search box and search for it. For example, you can enter `T123` or			global search box and search for it. For example, you can enter `T123` or
	`D456` to quickly jump to the corresponding task or code review, or enter a Git			`D456` to quickly jump to the corresponding task or code review, or enter a Git
	commit hash to jump to the corresponding commit. For a complete list of			commit hash to jump to the corresponding commit. For a complete list of
	supported commands, see @{article:Search User Guide: Shortcuts}.			supported commands, see @{article:Search User Guide: Shortcuts}.

	After running a search, you can scroll up to add filters and refine the result			After running a search, you can scroll up to add filters and refine the result
	set. You can also select Advanced Search from the dropdown menu to jump			set. You can also select Advanced Search from the dropdown menu to jump
	here immediately, or press return in the search box without entering a query.			here immediately, or press return in the search box without entering a query.

	This interface supports standard Phabricator search and filtering features,			This interface supports standard Phorge search and filtering features,
	like saved queries and typeaheads. See below for more details on using			like saved queries and typeaheads. See below for more details on using
	these features.			these features.


	Application Search			Application Search
	==================			==================

	Application search gives you a more powerful way to search one type of document,			Application search gives you a more powerful way to search one type of document,
	▲ Show 20 Lines • Show All 129 Lines • Show Last 20 Lines