Skip to content

Commit 97591d9

Browse files
chcomleychcomley
committed
preview fixes, new table markdown
1 parent 16c3ae4 commit 97591d9

File tree

1 file changed

+53
-213
lines changed

1 file changed

+53
-213
lines changed

‎docs/project/search/get-started-search.md‎

Lines changed: 53 additions & 213 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Search across Azure D## Prerequisites
3-
Description: Quickly search within Azure DevOps, across all your code, wiki, packages, and work items.
4-
ms.assetid: A0889E82-EAE7-464C-B82A-B05D2E404426
2+
title: Search across Azure DevOps
3+
Description: Quickly search within Azure DevOps
4+
id: A0889E82-EAE7-464C-B82A-B05D2E404426
55
ms.subservice: azure-devops-search
66
ms.custom: cross-service, cross-project
77
ms.topic: how-to
@@ -33,39 +33,13 @@ For detailed information about specific search types, see:
3333

3434
## Prerequisites
3535

36+
| Access level | Search capabilities |
37+
|---|---|
38+
| **All project members** | Every project member can use the search functions, including users with Stakeholder, Basic, and higher levels of access. |
39+
| **Stakeholder limitations** | - **Wiki search:** Limited to provisioned wikis only. Published wiki results don't appear because they require access to regular repositories.<br>- **Code search:** Not available for Stakeholder users. |
3640

37-
---
38-
:::row:::
39-
:::column span="1":::
40-
**Access level**
41-
:::column-end:::
42-
:::column span="2":::
43-
**Search capabilities**
44-
:::column-end:::
45-
:::row-end:::
46-
---
47-
:::row:::
48-
:::column span="1":::
49-
**All project members**
50-
:::column-end:::
51-
:::column span="2":::
52-
Every project member can use the search functions, including users with Stakeholder, Basic, and higher levels of access.
53-
:::column-end:::
54-
:::row-end:::
55-
---
56-
:::row:::
57-
:::column span="1":::
58-
**Stakeholder limitations**
59-
:::column-end:::
60-
:::column span="2":::
61-
- **Wiki search:** Limited to provisioned wikis only. Published wiki results don't appear because they require access to regular repositories.
62-
- **Code search:** Not available for Stakeholder users.
63-
:::column-end:::
64-
:::row-end:::
65-
---
66-
67-
**Important notes:**
68-
- **Access-based results:** When you search across the organization or collection, only results for projects and items you have access to display.
41+
> [!NOTE]
42+
> **Access-based results:** When you search across the organization or collection, only results for projects and items you have access to display.
6943
7044
::: moniker range="< azure-devops"
7145
> [!IMPORTANT]
@@ -86,117 +60,47 @@ For detailed information about specific search types, see:
8660
::: moniker range="azure-devops"
8761
The following features apply to all searches, including work items, code, wikis, and packages.
8862
::: moniker-end
89-
9063
::: moniker range="< azure-devops"
9164
The following features apply to all searches, including work items, code, and packages.
9265
::: moniker-end
9366

94-
---
95-
:::row:::
96-
:::column span="1":::
97-
**Search feature**
98-
:::column-end:::
99-
:::column span="2":::
100-
**Usage**
101-
:::column-end:::
102-
:::column span="2":::
103-
**Example**
104-
:::column-end:::
105-
:::row-end:::
106-
---
107-
:::row:::
108-
:::column span="1":::
109-
**Keyword**
110-
:::column-end:::
111-
:::column span="2":::
112-
Search based on one or more keywords.
113-
:::column-end:::
114-
:::column span="2":::
115-
`validate` finds instances that contain the word *validate*.
116-
:::column-end:::
117-
:::row-end:::
118-
---
119-
:::row:::
120-
:::column span="1":::
121-
**Exact match**
122-
:::column-end:::
123-
:::column span="2":::
124-
Search based on an exact match, enclosed in double-quotes.
125-
:::column-end:::
126-
:::column span="2":::
127-
`"Client not found"` finds instances that contain the exact phrase match *Client not found*. Search might not handle special characters as expected. Try escaping special characters or simplifying the search phrase.
128-
:::column-end:::
129-
:::row-end:::
130-
---
131-
:::row:::
132-
:::column span="1":::
133-
**Wildcard**
134-
:::column-end:::
135-
:::column span="2":::
136-
- Add wildcard characters, `*` and `?`, to keywords to extend the search criteria.
137-
- Add `*` at the end of a keyword to find items that start with the keyword.
138-
- Add `?` in the middle to represent any alphanumeric character.
139-
- Use wildcard characters anywhere in your search string except as a prefix. You can use prefix wildcards with the other search filter functions.
140-
- You can use more than one wildcard to match more than one character.
141-
:::column-end:::
142-
:::column span="2":::
143-
- `alpha?version` finds instances of alpha1version and alphaXversion.
144-
- `Browser*` finds instances of BrowserEdge, BrowserIE, and BrowserFirefox.
145-
- `CodeSenseHttp*` finds files containing words that start with *CodeSenseHttp*, such as CodeSenseHttpClient and CodeSenseHttpClientTest.
146-
:::column-end:::
147-
:::row-end:::
148-
---
149-
:::row:::
150-
:::column span="1":::
151-
**Boolean operators**
152-
:::column-end:::
153-
:::column span="2":::
154-
- Find two or more keywords using Boolean operators: `AND`, `OR`, and `NOT` (must be uppercase).
155-
- Add parenthesis to clauses to support logical groupings.
156-
- Because `AND` is the default operator, an entry of two keywords with no operator is the same as an `AND` search.
157-
:::column-end:::
158-
:::column span="2":::
159-
- `Validate AND revisit` finds files that contain both the words *validate* and *revisit*.
160-
- `Validate OR revisit` finds files that contain either of the words *validate* or *revisit*.
161-
- `Validate NOT revisit` finds files that contain the word *validate* but not the word, *revisit*.
162-
- `(Validate NOT revisit) OR "release delayed"` finds files that contain the word *validate* but not the word, *revisit, or files that contain the phrase *release delayed*.
163-
:::column-end:::
164-
:::row-end:::
165-
---
67+
| Search feature | Usage | Example |
68+
|---|---|---|
69+
|**Keyword**|Search based on one or more keywords|`validate` finds instances that contain the word *validate*|
70+
|**Exact match**|Search based on an exact match, enclosed in double-quotes|`"Client not found"` finds instances that contain the exact phrase match *Client not found*. Search might not handle special characters as expected. Try escaping special characters or simplifying the search phrase|
71+
|**Wildcard**|
72+
- Add wildcard characters, `*` and `?`, to keywords to extend the search criteria.<br>
73+
- Add `*` at the end of a keyword to find items that start with the keyword.<br>
74+
- Add `?` in the middle to represent any alphanumeric character.<br>
75+
- Use wildcard characters anywhere in your search string except as a prefix. You can use prefix wildcards with the other search filter functions.<br>
76+
- You can use more than one wildcard to match more than one character.|
77+
- `alpha?version` finds instances of alpha1version and alphaXversion.<br>
78+
- `Browser*` finds instances of BrowserEdge, BrowserIE, and BrowserFirefox.<br>
79+
- `CodeSenseHttp*` finds files containing words that start with *CodeSenseHttp*, such as CodeSenseHttpClient and CodeSenseHttpClientTest.| DevOps, across all your code, wiki, packages, and work items.|
80+
|**Boolean operators**|
81+
- Find two or more keywords using Boolean operators: `AND`, `OR`, and `NOT` (must be uppercase).<br>
82+
- Add parenthesis to clauses to support logical groupings.<br>
83+
- Because `AND` is the default operator, an entry of two keywords with no operator is the same as an `AND` search.<br>
84+
- `Validate AND revisit` finds files that contain both the words *validate* and *revisit*.|
85+
- `Validate OR revisit` finds files that contain either of the words *validate* or *revisit*.<br>
86+
- `Validate NOT revisit` finds files that contain the word *validate* but not the word, *revisit*.<br>
87+
- `(Validate NOT revisit) OR "release delayed"` finds files that contain the word *validate* but not the word, *revisit, or files that contain the phrase *release delayed*.|
88+
|**Special characters**|
89+
- Escape the special characters `(`, `)`, `[`, `]`, `:`, `*`, and `?` by enclosing them in a phrase delimited with double-quotes.<br>
90+
- Include special characters in a search string, or search specifically for special characters, according to the following rules:<br>
91+
- CodeA23?R finds files containing words that start with CodeA23<br>
92+
- Have any alphanumeric character next, and end with R. For example, CodeA234R and CodeA23QR.<br>
93+
- Search for any special character that isn't a part of the query language.|
94+
- `"flatten()"` finds the literal string *flatten()*. Search for a literal occurrence of the double-quote character *"* by preceding it with the escape character `\` and enclosing the search string in double-quotes.<br>
95+
- `"\"react-redux\""` finds the literal string "react-redux."|
16696
::: moniker range="azure-devops"
167-
:::row:::
168-
:::column span="1":::
169-
**Proximity**
170-
:::column-end:::
171-
:::column span="2":::
172-
- Search for files based on vicinity using proximity operators: NEAR, BEFORE, and AFTER (must be uppercase).
173-
- By default, proximity search looks for terms within five tokens distance.
174-
:::column-end:::
175-
:::column span="2":::
176-
- `term1 BEFORE term2` returns all files where term1 occurs BEFORE term2 within a distance of five tokens between them.
177-
- `term1 AFTER term2` returns the same results as term2 BEFORE term1.
178-
- `term1 NEAR term2` returns all files where term1 is within five token distance from term2 in any direction. `term1 NEAR term2` returns the same results as `term1 BEFORE term2` OR `term2 BEFORE term1`.
179-
:::column-end:::
180-
:::row-end:::
97+
|**Proximity**|
98+
- Search for files based on vicinity using proximity operators: NEAR, BEFORE, and AFTER (must be uppercase).<br>
99+
- By default, proximity search looks for terms within five tokens distance.|
100+
- `term1 BEFORE term2` returns all files where term1 occurs BEFORE term2 within a distance of five tokens between them.<br>
101+
- `term1 AFTER term2` returns the same results as term2 BEFORE term1.<br>
102+
- `term1 NEAR term2` returns all files where term1 is within five token distance from term2 in any direction. `term1 NEAR term2` returns the same results as `term1 BEFORE term2` OR `term2 BEFORE term1`.|
181103
::: moniker-end
182-
---
183-
:::row:::
184-
:::column span="1":::
185-
**Special characters**
186-
:::column-end:::
187-
:::column span="2":::
188-
- Escape the special characters `(`, `)`, `[`, `]`, `:`, `*`, and `?` by enclosing them in a phrase delimited with double-quotes.
189-
- Include special characters in a search string, or search specifically for special characters, according to the following rules:
190-
- CodeA23?R finds files containing words that start with CodeA23
191-
- Have any alphanumeric character next, and end with R. For example, CodeA234R and CodeA23QR.
192-
- Search for any special character that isn't a part of the query language.
193-
:::column-end:::
194-
:::column span="2":::
195-
- `"flatten()"` finds the literal string *flatten()*. Search for a literal occurrence of the double-quote character *"* by preceding it with the escape character `\` and enclosing the search string in double-quotes.
196-
- `"\"react-redux\""` finds the literal string "react-redux."
197-
:::column-end:::
198-
:::row-end:::
199-
---
200104

201105
## Search from different contexts
202106

@@ -220,81 +124,17 @@ The search experience adapts based on where you start your search:
220124

221125
The following table shows other search tasks and where to find them:
222126

223-
---
224-
:::row:::
225-
:::column span="1":::
226-
**Search task**
227-
:::column-end:::
228-
:::column span="2":::
229-
**Action**
230-
:::column-end:::
231-
:::row-end:::
232-
---
127+
| Search task | Action |
128+
|---|---|
233129
::: moniker range="azure-devops"
234-
:::row:::
235-
:::column span="1":::
236-
Find an organization setting
237-
:::column-end:::
238-
:::column span="2":::
239-
Go to your organization and select **Organization settings**.
240-
:::column-end:::
241-
:::row-end:::
130+
| **Find an organization setting** | Go to your organization and select **Organization settings**. |
242131
::: moniker-end
243-
---
244-
:::row:::
245-
:::column span="1":::
246-
Find a project setting
247-
:::column-end:::
248-
:::column span="2":::
249-
Go to your project and select **Project settings**.
250-
:::column-end:::
251-
:::row-end:::
252-
---
253-
:::row:::
254-
:::column span="1":::
255-
Find a user setting
256-
:::column-end:::
257-
:::column span="2":::
258-
Go to your **User settings page**.
259-
:::column-end:::
260-
:::row-end:::
261-
---
262-
:::row:::
263-
:::column span="1":::
264-
Find a user
265-
:::column-end:::
266-
:::column span="2":::
267-
Go to your organization and select **Organization settings** > **Users**, and then enter the name in the filter box.
268-
:::column-end:::
269-
:::row-end:::
270-
---
271-
:::row:::
272-
:::column span="1":::
273-
Find an organization
274-
:::column-end:::
275-
:::column span="2":::
276-
Scroll through the left side of your screen, which lists all organizations.
277-
:::column-end:::
278-
:::row-end:::
279-
---
280-
:::row:::
281-
:::column span="1":::
282-
Find a project
283-
:::column-end:::
284-
:::column span="2":::
285-
Go to your organization, and then enter the project name in the Filter projects box.
286-
:::column-end:::
287-
:::row-end:::
288-
---
289-
:::row:::
290-
:::column span="1":::
291-
View file history and compare versions
292-
:::column-end:::
293-
:::column span="2":::
294-
Go to **Repos** > **Files**, highlight your file, and then select **History**.
295-
:::column-end:::
296-
:::row-end:::
297-
---
132+
| **Find a project setting** | Go to your project and select **Project settings**. |
133+
| **Find a user setting** | Go to your **User settings page**. |
134+
| **Find a user** | Go to your organization and select **Organization settings** > **Users**, and then enter the name in the filter box. |
135+
| **Find an organization** | Scroll through the left side of your screen, which lists all organizations. |
136+
| **Find a project** | Go to your organization, and then enter the project name in the Filter projects box. |
137+
| **View file history and compare versions** | Go to **Repos** > **Files**, highlight your file, and then select **History**. |
298138

299139
::: moniker range="azure-devops"
300140
> [!NOTE]

0 commit comments

Comments
 (0)