Update search dev documentation
What does this MR do and why?
This MR introduces more changes (hopefully the last big restructure) to the advanced search dev docs:
- reorganization (I used claude to help)
- changing deep dive list to table
- removing legacy architecture diagram/info
- adding info about migration framework
- adding postgres to elasticsearch mapping examples
- more info on custom routing + how it impacts project/group transfers
- add a link to updating search API (if needed) for new scopes
AI summary
This update reorganizes and enhances the Advanced Search development documentation. The page now has a clearer structure with better formatting, including a table of deep dive resources with dates, presenters, and links. The content adds more detailed sections on architecture, indexing components, and the migration framework. It explains how data flows through the system, from initial indexing to ongoing updates, and provides more troubleshooting guidance. The document now better describes the relationship between GitLab and Elasticsearch/OpenSearch, including how different types of data (database records, Git repositories, embeddings) are indexed through different pipelines. Overall, it transforms a basic reference page into a more comprehensive guide for developers working with Advanced Search.
References
- took some ideas from !182131 (diffs)
- a follow up from comments in !189689 (merged)
Screenshots or screen recordings
| Before | After |
|---|---|
How to set up and validate locally
MR acceptance checklist
Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.