To support WDQS users in migrating to the new backend, the migration guide that we create (eventually, at https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/WDQS_backend_update) needs to have some overview content to orient people to the technical aspects of the migration process. This information is less detailed than what is in the full technical documentation (see T431843 and subtasks); basically, it should capture the key takeaways from the architecture redesign and query rewrite documentation (linked below), so that readers can quickly determine whether they need to consult those more in-depth pages.
Tasks to complete:
- Research and consultation with project owners and SMEs
- Define and draft content for sub-section of the Migration guide: "Determine if you need to migrate" (and/or, "Identify impacted queries")
- Define and draft content for sub-section of the Migration guide: "Migrate your queries", include best practices for adapting all Blazegraph dependencies to the new system, or alternative endpoints where needed. Capture high-level takeaways from the very detailed documentation of query rewrites and example queries (T431469), and provide links to that documentation for deeper exploration:
- Graph Analytic Services (GAS)
- MediaWiki API (MWAPI) Service
- Label and Utility Services
- Geospatial Functions
- Get review from stakeholders and publish on-wiki
- Integrate learnings from pilot teams as they migrate, add a Troubleshooting section or callouts to capture common issues or areas of confusion during migration