Merge pull request #14633 from planteater/feature/unified-identity

Feature/unified identity

src/content/docs/codestream/code-discussion/activity-feed-search.mdx

@@ -0,0 +1,347 @@
+---
+title: Activity feed and search
+metaDescription: "Finding discussions through the activity feed and search."
+redirects:
+freshnessValidatedDate: 2024-12-11
+---
+
+import codestreamActivityFeedBadge from 'images/codestream_screenshot-crop_activity-feed-badge-icon.webp'
+
+import codestreamStatusBarMentions from 'images/codestream_screenshot-crop_status-bar-mentions.webp'
+
+import codestreamFilterandSearchBar from 'images/codestream_screenshot-crop_filter-and-search-bar.webp'
+
+
+CodeStream's **Activity Feed** allows you to participate in ongoing discussions, and the **Filter & Search** page allows you to access any discussion, including older ones.
+
+## Activity feed [#activityfeed]
+
+The activity feed is the definitive place to find out about new comments and issues posted by your teammates or new replies to existing discussions. When you're not on the activity feed, you can always tell whether or not there's anything new by looking for a badge on the activity feed icon. A blue badge with a white dot means that there are new discussions or replies.
+
+<img
+  title="badge"
+  alt="This image shows an badge on the activity feed icon."
+  src={codestreamActivityFeedBadge}
+/>
+
+CodeStream's entry in your IDE's status bar also lets you know when there are new messages in the feed. A dot to the right of your username means there are new messages and a number means there are new mentions.
+
+<img
+  title="ide-status"
+  alt="This image shows how CodeStream appears in your IDE's status bar"
+  src={codestreamStatusBarMentions}
+/>
+
+The filter at the top of the activity feed controls what you see in the feed.
+
+* **Activity from everyone in my organization**: See all of the activity from your organization. We only recommend this for small organizations.
+* **Activity associated with code open in my IDE (default)**: See discussions related to code in the repositories you have open in your IDE.
+* **Activity associated with code in selected folder**: Use this option if your team is working within monorepos. See discussions related to code in the currently selected folder.
+
+Regardless of your filter settings, you'll always be notified when you're @mentioned.
+
+## Filter and search [#filtersearch]
+
+The filter and search tools allow you to slice and dice your organization's collection of comments and issues however you see fit. By default, you'll get a view of any open issues assigned to you, followed by all open issues.
+
+<img
+  title="filter"
+  alt="A screenshot showing the filter and search tool."
+  src={codestreamFilterandSearchBar}
+/>
+
+Use [advanced search syntax](#advanced-search) to create your own searches. You can save them for future use via the bookmark icon at the right side of the search box, or click on the **Filter** button to leverage predefined filters.
+
+## Advanced search syntax [#advanced-search]
+
+<table>
+  <thead>
+    <tr>
+      <th style={{ width: "200px" }}>
+        Syntax
+      </th>
+
+      <th>
+        Definition
+      </th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <td>
+        `status:open`
+      </td>
+
+      <td>
+        Returns all open comments and issues.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `status:closed`
+      </td>
+
+      <td>
+        Returns all resolved comments and issues.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `type:issue`
+      </td>
+
+      <td>
+        Returns all issues.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `type:comment`
+      </td>
+
+      <td>
+        Returns all comments.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `is:`
+      </td>
+
+      <td>
+        Use `open`, `closed`, `issue` or `comment` for the same results as the status and type filters above.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `author:@`
+      </td>
+
+      <td>
+        Returns all comments and issues authored by you (`@me`) or any teammate (`@username`).
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `mentions:@`
+      </td>
+
+      <td>
+        Returns all comments and issues where you (`@me`) or any teammate (`@username`) have been mentioned in either the title or description.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `assignee:@`
+      </td>
+
+      <td>
+        Returns all issues assigned to you (`@me`) or a teammate (`@username`).
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `tag:`
+      </td>
+
+      <td>
+        Returns all comments and issues with a specific tag. Use quotes around multi-word tags (for example, `tag:"api server"`). You can combine multiple tags to create an AND query. For example, `tag:blue tag:green` will return items that have both blue and green tags.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `no:tag`
+      </td>
+
+      <td>
+        Returns all comments and issues that have no tags.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `branch:`
+      </td>
+
+      <td>
+        Returns all comments and issues created against the specified branch.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `commit:`
+      </td>
+
+      <td>
+        Returns all comments and issues that include code with the specified commit ID.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `repo:`
+      </td>
+
+      <td>
+        Returns all comments and issues created against code in the specified repository.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `created:today`
+      </td>
+
+      <td>
+        Returns all comments and issues created today.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `created:yesterday`
+      </td>
+
+      <td>
+        Returns all comments and issues created yesterday.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `created:YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues created on a specific date.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `created:<YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues created before a specific date.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `created:>YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues created after a specific date.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `updated:YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues updated on a specific date.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `updated:<YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues updated before a specific date.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `updated:>YYYY-MM-DD`
+      </td>
+
+      <td>
+        Returns all comments and issues updated after a specific date.
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+## Keyboard shortcuts [#keyboard-shortcuts]
+
+Here's a table of CodeStream keyboard shortcuts for Windows/Linux, and macOS.
+
+<table>
+  <thead>
+    <tr>
+      <th style={{ width: "200px" }}>
+        Action
+      </th>
+
+      <th>
+        Windows/Linux
+      </th>
+
+      <th>
+        macOS
+      </th>
+    </tr>
+  </thead>
+
+  <tbody>
+    <tr>
+      <td>
+        New comment
+      </td>
+
+      <td>
+        `ctrl+shift+c`
+      </td>
+
+      <td>
+        `ctrl+c`
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        New issue
+      </td>
+
+      <td>
+        `ctrl+shift+i`
+      </td>
+
+      <td>
+        `ctrl+i`
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        Toggle CodeStream pane
+      </td>
+
+      <td>
+        `ctrl+shift+/`
+      </td>
+
+      <td>
+        `ctrl+/`
+      </td>
+    </tr>
+  </tbody>
+</table>