~/talk

The Search for Search

Talkat Write the Docs Portland 2020 · 2020-08-09..08-11· [developer-experience]
links:none on file
slides:none on file

Adds a site search to api.slack.com by indexing a unified catalog of docs and calling the Algolia REST API from the monolithic Hack/PHP codebase, not using instant typeahead. Engineers write 800+ taglines to give each result useful context, de-prioritize legacy pages, add filters and color coding, and log queries; malicious noise drops after blocked malicious Python clients. Search ships, works, and increases relevant traffic while adding ongoing maintenance and analytics work.

AI-written summary · about

  1. 0:00Introduction
  2. 0:32About me
  3. 1:47The story
  4. 7:31Custom CMS
  5. 8:41Search Client
  6. 10:24Instant Search
  7. 16:16Taglines
  8. 16:41User Stories
  9. 18:50Experiments
  10. 19:37Metadata
  11. 20:27Feedback Component
  12. 21:24Search Cuts Through Layers
  13. 23:26Wrap Up
  14. 24:17Pauls Background
  15. 26:29Primary Users
  16. 27:45Elastic Search
  17. 30:13Web Crawler Service
  18. 31:28Document Schema
  19. 34:08Search Results
  20. 36:06References
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.