diff --git a/src/applications/search/query/PhabricatorSearchApplicationSearchEngine.php b/src/applications/search/query/PhabricatorSearchApplicationSearchEngine.php index 3ebc0cef9f..e251d23e6f 100644 --- a/src/applications/search/query/PhabricatorSearchApplicationSearchEngine.php +++ b/src/applications/search/query/PhabricatorSearchApplicationSearchEngine.php @@ -114,7 +114,7 @@ final class PhabricatorSearchApplicationSearchEngine PhabricatorSearchRelationship::RELATIONSHIP_CLOSED => pht('Closed'), ); $status_control = id(new AphrontFormCheckboxControl()) - ->setLabel(pht('Document Status')); + ->setLabel(pht('Item Status')); foreach ($statuses as $status => $name) { $status_control->addCheckbox( 'statuses[]', @@ -127,7 +127,7 @@ final class PhabricatorSearchApplicationSearchEngine $type_values = array_fuse($type_values); $types_control = id(new AphrontFormTokenizerControl()) - ->setLabel(pht('Document Types')) + ->setLabel(pht('Item Types')) ->setName('types') ->setDatasource(new PhabricatorSearchDocumentTypeDatasource()) ->setValue($type_values); @@ -180,8 +180,8 @@ final class PhabricatorSearchApplicationSearchEngine protected function getBuiltinQueryNames() { return array( - 'all' => pht('All Documents'), - 'open' => pht('Open Documents'), + 'all' => pht('All Items'), + 'open' => pht('Open Items'), 'open-tasks' => pht('Open Tasks'), ); } diff --git a/src/applications/search/typeahead/PhabricatorSearchDocumentTypeDatasource.php b/src/applications/search/typeahead/PhabricatorSearchDocumentTypeDatasource.php index 9b94d0b24d..2be8687ff0 100644 --- a/src/applications/search/typeahead/PhabricatorSearchDocumentTypeDatasource.php +++ b/src/applications/search/typeahead/PhabricatorSearchDocumentTypeDatasource.php @@ -4,11 +4,11 @@ final class PhabricatorSearchDocumentTypeDatasource extends PhabricatorTypeaheadDatasource { public function getBrowseTitle() { - return pht('Browse Document Types'); + return pht('Browse Item Types'); } public function getPlaceholderText() { - return pht('Select a document type...'); + return pht('Select an item type...'); } public function getDatasourceApplicationClass() { diff --git a/src/docs/user/userguide/search.diviner b/src/docs/user/userguide/search.diviner index b10e4c147c..c6b389b893 100644 --- a/src/docs/user/userguide/search.diviner +++ b/src/docs/user/userguide/search.diviner @@ -1,12 +1,12 @@ @title Search User Guide @group userguide -Introduction to searching for documents in Phorge. +Introduction to searching for items and objects in Phorge. Overview ======== -Phorge has two major ways to search for documents and objects (like tasks, +Phorge has two major ways to search for items (like tasks, code reviews, users, wiki documents, and so on): **global search** and **application search**. @@ -15,7 +15,7 @@ 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. **Application search** allows you to search within an application (like -Maniphest) for documents of a specific type. Because application search is only +Maniphest) for items of a specific type. Because application search is only searching one type of object, it can provide more powerful options for filtering, ordering, and displaying the results. @@ -35,13 +35,13 @@ 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. 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 items 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 search, you'll get matching wiki documents. 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, -Phorge will search all documents. +application which doesn't have any searchable items. In these cases, +Phorge will search all items. 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 @@ -63,8 +63,8 @@ Application Search Application search gives you a more powerful way to search one type of document, like tasks. Most applications provide application search interfaces for the -documents or objects they let you create: these pages have queries in the left -menu, show objects or documents in the main content area, and have controls +items they let you create: these pages have queries in the left +menu, show items in the main content area, and have controls for refining the results. These interfaces support **saved queries** and **typeaheads**. @@ -145,25 +145,25 @@ some special syntax. These features are supported: See below for more detail. **Substrings**: Normally, query terms are searched for as words, so searching -for `read` won't find documents which only contain the word `threaded`, even +for `read` won't find items which only contain the word `threaded`, even though "read" is a substring of "threaded". With the substring operator, `~`, -you can search for substrings instead: the query `~read` will match documents +you can search for substrings instead: the query `~read` will match items which contain that text anywhere, even in the middle of a word. -**Quoted Terms**: When you search for multiple terms, documents which match +**Quoted Terms**: When you search for multiple terms, items which match each term will be returned, even if the terms are not adjacent in the document. For example, the query `void star` will match a document titled `A star in the void`, because it matches both `void` and `star`. To search for an exact sequence of terms, quote them: `"void star"`. This query will only match -documents which use those terms as written. +items which use those terms as written. -**Stemming**: Searching for a term like `rearming` will find documents which +**Stemming**: Searching for a term like `rearming` will find items which contain variations of the word, like `rearm`, `rearms`, and `rearmed`. To search for an an exact word, quote the term: `"rearming"`. **Field Search**: By default, query terms are searched for in the title, body, and comments. If you only want to search for a term in titles, use `title:`. -For example, `title:platypus` only finds documents with that term in the +For example, `title:platypus` only finds items with that term in the title. This can be combined with other operators, for example `title:~platypus` or `title:"platypus attorney"`. These scopes are also supported: @@ -172,15 +172,15 @@ or `title:"platypus attorney"`. These scopes are also supported: - `core:...` searches titles and bodies, but not comments. - `comment:...` searches only comments. -**Filtering Matches**: You can remove documents which match certain terms from -the result set with `-`. For example: `platypus -mammal`. Documents which match +**Filtering Matches**: You can remove items which match certain terms from +the result set with `-`. For example: `platypus -mammal`. Items which match negated terms will be filtered out of the result set. **Matching Entire Fields**: If you know the exact name of an object and want to find only that object, you can use the `=` operator. A query like `title:"warp drive"` will find a document titled "Warp Drive", but will also -find documents with longer titles, like "Not a Warp Drive". The `=` operator -requires that the entire field match the query exactly, so //only// documents +find items with longer titles, like "Not a Warp Drive". The `=` operator +requires that the entire field match the query exactly, so //only// items exactly titled "Warp Drive" will be matched by the query (but note that the query is still case insensitive). diff --git a/src/view/page/menu/PhabricatorMainMenuSearchView.php b/src/view/page/menu/PhabricatorMainMenuSearchView.php index 639a6fe62b..2ad1f6be66 100644 --- a/src/view/page/menu/PhabricatorMainMenuSearchView.php +++ b/src/view/page/menu/PhabricatorMainMenuSearchView.php @@ -129,7 +129,7 @@ final class PhabricatorMainMenuSearchView extends AphrontView { $items[] = array( 'icon' => 'fa-globe', - 'name' => pht('All Documents'), + 'name' => pht('All Items'), 'value' => 'all', );