Skip to content

Add missing sort options to sorting search results documentation #38603

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 29, 2025

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented May 29, 2025

This PR adds comprehensive documentation for missing sort options in the GitHub search functionality to the "Sorting search results" page.

Changes Made

New Sort Sections Added:

  • Sort by comments: Added sort:comments, sort:comments-asc, and sort:comments-desc options
  • Sort by created date: Added sort:created, sort:created-asc, and sort:created-desc options
  • Sort by relevance: Added sort:relevance and sort:relevance-desc options

Expanded Reactions Section:

Added comprehensive documentation for all reaction-based sort options with both ascending and descending variants:

  • sort:reactions-+1-asc and sort:reactions-+1-desc
  • sort:reactions--1-asc and sort:reactions--1-desc
  • sort:reactions-smile-asc and sort:reactions-smile-desc
  • sort:reactions-tada-asc and sort:reactions-tada-desc
  • sort:reactions-heart-asc and sort:reactions-heart-desc
  • sort:reactions-thinking_face, sort:reactions-thinking_face-asc, and sort:reactions-thinking_face-desc
  • sort:reactions-rocket, sort:reactions-rocket-asc, and sort:reactions-rocket-desc
  • sort:reactions-eyes, sort:reactions-eyes-asc, and sort:reactions-eyes-desc

Additional Updates:

  • Updated the introductory text to mention all available sort categories
  • Each new sort option includes example usage with properly formatted GitHub search links
  • Consistent formatting and structure maintained throughout the document

All missing sort options mentioned in the original issue have been added with complete documentation including examples and proper formatting.

Fixes #38455.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

If you need me to access, download, or install something from one of these locations, you can either:


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: hubwriter <54933897+hubwriter@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Missing sort options in "Sorting search results" documentation Add missing sort options to sorting search results documentation May 29, 2025
@Copilot Copilot AI requested a review from hubwriter May 29, 2025 11:38
Copilot finished work on behalf of hubwriter May 29, 2025 11:39
@hubwriter hubwriter marked this pull request as ready for review May 29, 2025 11:49
@Copilot Copilot AI review requested due to automatic review settings May 29, 2025 11:49
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances the "Sorting search results" documentation by adding missing sort qualifiers and examples.

  • Added new sections for sorting by comments, created date, and relevance, each with qualifier descriptions and example links
  • Expanded the reactions table in the Sort by interactions section to include ascending and descending variants for each reaction type
  • Updated the introductory bullet to list all available sort categories
Comments suppressed due to low confidence (1)

content/search-github/getting-started-with-searching-on-github/sorting-search-results.md:25

  • Prefix this line with - to maintain the markdown list format (e.g., - To sort by interactions…).
To sort by interactions, reactions, comments, created date, relevance, author date, committer date, or how recently the items were updated, you can add a `sort` qualifier to your search query.

Copy link
Contributor

github-actions bot commented May 29, 2025

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
search-github/getting-started-with-searching-on-github/sorting-search-results.md fpt
ghec
ghes@ 3.17 3.16 3.15 3.14 3.13
fpt
ghec
ghes@ 3.17 3.16 3.15 3.14 3.13

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@40l9
Copy link

40l9 commented May 29, 2025 via email

| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions--1**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions--1&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thumbs down (:-1:) reactions.
| `sort:reactions--1-asc` | [**org:github sort:reactions--1-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions--1-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending thumbs down (:-1:) reactions (the fewest to the most).
| `sort:reactions--1-desc` | [**org:github sort:reactions--1-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions--1-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending thumbs down (:-1:) reactions (the most to the fewest).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-smile**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-smile&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most laugh (:smile:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is no longer needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-smile**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-smile&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most laugh (:smile:) reactions.
| `sort:reactions-smile-asc` | [**org:github sort:reactions-smile-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-smile-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending laugh (:smile:) reactions (the fewest to the most).
| `sort:reactions-smile-desc` | [**org:github sort:reactions-smile-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-smile-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending laugh (:smile:) reactions (the most to the fewest).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-tada**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-tada&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most hurray (:tada:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is no longer needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

@@ -42,10 +68,29 @@ The `sort:reactions` qualifier sorts by the number or type of reactions.
| `sort:reactions` or `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by the highest number of reactions.
| `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending number of reactions (the fewest to the most).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thumbs up (:+1:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is no longer needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

@@ -42,10 +68,29 @@ The `sort:reactions` qualifier sorts by the number or type of reactions.
| `sort:reactions` or `sort:reactions-desc` | [**org:github sort:reactions**](https://github.com/search?q=org%3Agithub+sort%3Areactions&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by the highest number of reactions.
| `sort:reactions-asc` | [**org:github sort:reactions-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending number of reactions (the fewest to the most).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-+1**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thumbs up (:+1:) reactions.
| `sort:reactions-+1-asc` | [**org:github sort:reactions-+1-asc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending thumbs up (:+1:) reactions (the fewest to the most).
| `sort:reactions-+1-desc` | [**org:github sort:reactions-+1-desc**](https://github.com/search?q=org%3Agithub+sort%3Areactions-%2B1-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending thumbs up (:+1:) reactions (the most to the fewest).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions--1**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions--1&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thumbs down (:-1:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is no longer needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-tada**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-tada&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most hurray (:tada:) reactions.
| `sort:reactions-tada-asc` | [**org:github sort:reactions-tada-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-tada-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending hurray (:tada:) reactions (the fewest to the most).
| `sort:reactions-tada-desc` | [**org:github sort:reactions-tada-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-tada-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending hurray (:tada:) reactions (the most to the fewest).
| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-heart**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-heart&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most heart (:heart:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is no longer needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

| `sort:reactions-thinking_face-asc` | [**org:github sort:reactions-thinking_face-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending thinking face (:thinking_face:) reactions (the fewest to the most).
| `sort:reactions-thinking_face-desc` | [**org:github sort:reactions-thinking_face-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending thinking face (:thinking_face:) reactions (the most to the fewest).
| `sort:reactions-rocket` | [**org:github sort:reactions-rocket**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most rocket (:rocket:) reactions.
| `sort:reactions-rocket-asc` | [**org:github sort:reactions-rocket-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending rocket (:rocket:) reactions (the fewest to the most).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `sort:reactions-rocket-asc` | [**org:github sort:reactions-rocket-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending rocket (:rocket:) reactions (the fewest to the most).
| `sort:reactions-rocket` or `sort:reactions-rocket-asc` | [**org:github sort:reactions-rocket-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending rocket (:rocket:) reactions (the fewest to the most).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to show both sort:reactions-rocket and sort:reactions-rocket-asc as alternatives in commit c912567.

| `sort:reactions-rocket-asc` | [**org:github sort:reactions-rocket-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending rocket (:rocket:) reactions (the fewest to the most).
| `sort:reactions-rocket-desc` | [**org:github sort:reactions-rocket-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending rocket (:rocket:) reactions (the most to the fewest).
| `sort:reactions-eyes` | [**org:github sort:reactions-eyes**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-eyes&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most eyes (:eyes:) reactions.
| `sort:reactions-eyes-asc` | [**org:github sort:reactions-eyes-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-eyes-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending eyes (:eyes:) reactions (the fewest to the most).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `sort:reactions-eyes-asc` | [**org:github sort:reactions-eyes-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-eyes-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending eyes (:eyes:) reactions (the fewest to the most).
| `sort:reactions-eyes` or `sort:reactions-eyes-asc` | [**org:github sort:reactions-eyes-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-eyes-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending eyes (:eyes:) reactions (the fewest to the most).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to show both sort:reactions-eyes and sort:reactions-eyes-asc as alternatives in commit c912567.

| <code>sort:reactions-<em>reaction</em></code> | [**org:github sort:reactions-heart**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-heart&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most heart (:heart:) reactions.
| `sort:reactions-heart-asc` | [**org:github sort:reactions-heart-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-heart-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending heart (:heart:) reactions (the fewest to the most).
| `sort:reactions-heart-desc` | [**org:github sort:reactions-heart-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-heart-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending heart (:heart:) reactions (the most to the fewest).
| `sort:reactions-thinking_face` | [**org:github sort:reactions-thinking_face**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thinking face (:thinking_face:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is not needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

| `sort:reactions-thinking_face` | [**org:github sort:reactions-thinking_face**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most thinking face (:thinking_face:) reactions.
| `sort:reactions-thinking_face-asc` | [**org:github sort:reactions-thinking_face-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending thinking face (:thinking_face:) reactions (the fewest to the most).
| `sort:reactions-thinking_face-desc` | [**org:github sort:reactions-thinking_face-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-thinking_face-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending thinking face (:thinking_face:) reactions (the most to the fewest).
| `sort:reactions-rocket` | [**org:github sort:reactions-rocket**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most rocket (:rocket:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is not needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

| `sort:reactions-rocket` | [**org:github sort:reactions-rocket**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most rocket (:rocket:) reactions.
| `sort:reactions-rocket-asc` | [**org:github sort:reactions-rocket-asc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending rocket (:rocket:) reactions (the fewest to the most).
| `sort:reactions-rocket-desc` | [**org:github sort:reactions-rocket-desc**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-rocket-desc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by descending rocket (:rocket:) reactions (the most to the fewest).
| `sort:reactions-eyes` | [**org:github sort:reactions-eyes**](https://github.com/search?utf8=%E2%9C%93&q=org%3Agithub+sort%3Areactions-eyes&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by most eyes (:eyes:) reactions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry is not needed. Delete it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Entry deleted as requested in commit c912567.

…R feedback

Co-authored-by: hubwriter <54933897+hubwriter@users.noreply.github.com>
Copilot finished work on behalf of hubwriter May 29, 2025 15:17
@40l9
Copy link

40l9 commented May 29, 2025 via email

@hubwriter hubwriter added this pull request to the merge queue May 29, 2025
Merged via the queue into main with commit 574274f May 29, 2025
59 checks passed
@hubwriter hubwriter deleted the copilot/fix-38455 branch May 29, 2025 15:43
Copy link
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues

| `sort:created` or `sort:created-desc` | [**org:github sort:created**](https://github.com/search?q=org%3Agithub+sort%3Acreated&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by the most recently created date.
| `sort:created-asc` | [**org:github sort:created-asc**](https://github.com/search?q=org%3Agithub+sort%3Acreated-asc&type=Issues) matches issues in repositories owned by {% data variables.product.github %}, sorted by ascending created date (oldest to newest).

## Sort by relevance
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Down

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Error loading sessions

Retrying...

Successfully merging this pull request may close these issues.

Missing sort options in "Sorting search results" documentation
5 participants