Create advanced search page to communicate current features (and potentially future priorities)

[patcon]

Hey! I'd like there to be a version-controlled page in which people can improve docs about how advanced search currently works, and comparing features and assumptions between similar micro-blogging services. Not just search operators, but how search differs between (e.g. apostrophes in search on twitter vs bluesky, like #hashtag's vs #hashtag's)

Background

I'm aware that this blog post exists:

Blog: Tips and Tricks for Bluesky Search https://bsky.social/about/blog/05-31-2024-search

And I'm already tracking these issue:

• Feature request: Advanced search operators social-app#3378
• advanced search feature-request : ability to know supported keyword/search logic/tips social-app#4093 (this will address that one)

Here are Twitters analogous docs, for comparison:

• X Developer Docs
  • Rules and filtering: Standard v1.1
    • https://developer.x.com/en/docs/x-api/v1/rules-and-filtering/search-operators
  • Search Tweets: Standard v1.1
    • https://developer.x.com/en/docs/x-api/v1/tweets/search/guides/standard-operators
  • Search API: Enterprise
    • https://developer.x.com/en/docs/x-api/enterprise/search-api/overview
  • X API v2: Search Tweets
    • https://developer.x.com/en/docs/x-api/tweets/search/introduction
  • X API v1.1 vs v2 comparison/migration
    • https://developer.x.com/en/docs/x-api/tweets/search/migrate

To Do

• sketch out current state of bluesky search in doc
• create comparison doc with Twitter/X
• create comparison doc with Mastodon
• create section linking to resources on future search features and priorities (maybe too advanced for user-facing docs, so would require large caveats around the link, if included)

Content stubbing

Admins, please feel welcome to copy and update this table below in a later comment, esp if I'm not prompt in updating it myself :) This is a work-in-progress, as I won't have time to finish this research today 🙏

Operator	Example	Bluesky	Tw/X v1	Tw/X v2
AND	watching now	✅	✅
exact phrase	"happy hour"	❓	✅
OR	love OR hate	❌	✅
negation/not	beer -root	❌	✅
hashtag	#haiku	✅*1	✅
from	from:@support.bsky.team	✅	✅
to	to:@support.bsky.team	✅	✅
list	list:NASA/astronauts-in-space-now	❌	✅	✅ *2
lang	polis lang:en	✅	✅	✅
me	to:me from:me [...]	✅	❓
filter	filter:images filter:links [...]	❌	✅	❌
url	url:amazon	❌	✅	✅
domain	domain:google.com	✅	❌	❌
card_domain	card_domain:google.com	❌	✅	❌
since	puppy since:2015-12-21	❌	✅
until	puppy until:2015-12-21	❌	✅
sentiment	puppy :) puppy :(	❌	✅	❌
questions	puppy ?	❌	✅	❌
min_replies	puppy min_replies:3	❌	✅	❌
min_retweets	puppy retweets:3	❌	✅	❌
min_faves	puppy min_faves:3	❌	✅	❌

1. *^{hashtags include apostrophes on bluesky}
2. *^{only works in v2 Pro, not basic}