User:TiagoLubiana/Diátaxis framework for MediaWiki docs

The Diátaxis framework is a framework to add structure to documentation.

It basically divides documentation in 4 large categories:


 * Tutorials, which are learning-oriented and direct, aiming to get a user started in some tool or feature
 * Explanations, which are understanding-oriented and often more lengthy
 * How-to-guides, which explain some aspect of the tool in detail, handling
 * References, which are comprehensive repositories, in which all the technical details are present

The goal of this document is to try and organize documentation available on the MediaWiki projects inside that framework, so as to identify gaps and improve the usefulness of docs.

The initial focus will be on the Wikidata Query Service.

= Wikidata Query Service =

Tutorials

 * https://wdqs-tutorial.toolforge.org/
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial
 * https://www.wikidata.org/wiki/File:Querying_Wikidata_with_SPARQL_for_Absolute_Beginners.webm
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Building_a_query
 * https://github.com/wikimedia/wikidata-query-rdf/blob/master/docs/exploring-linked-data.md
 * https://outreachdashboard.wmflabs.org/training/wikidata/querying-wikidata
 * https://docs.data.world/tutorials/sparql/

Explanations

 * https://wikimedia.org.il/about-the-wikidata-query-service-tutorial/
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/A_gentle_introduction_to_the_Wikidata_Query_Service
 * https://wikitech.wikimedia.org/wiki/Wikidata_Query_Service/Technical_interactions
 * https://lists.wikimedia.org/hyperkitty/list/wikidata@lists.wikimedia.org/message/N2HPRCYIWGLM2IDTNCHQLNY574H5ZEQR/


 * https://longair.net/blog/2017/11/29/sparql-wikidata/
 * https://addshore.com/2019/10/your-own-wikidata-query-service-with-no-limits/
 * Actually, basically anything at https://addshore.com/?s=wikidata+query+service


 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/WDQS_backend_update
 * https://upload.wikimedia.org/wikipedia/commons/e/ea/WDQS_Backend_Alternatives_working_paper.pdf


 * https://aidanhogan.com/docs/wikidata-sparql-relational-graph.pdf


 * Navigating the Maze of Wikidata Query Logs https://inria.hal.science/hal-02096714

How-to-guides

 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/query_optimization
 * https://wikitech.wikimedia.org/wiki/Wikidata_Query_Service (also a reference)
 * https://github.com/wikimedia/wikidata-query-rdf/blob/master/docs/getting-started.md
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_federation_input
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Wikidata_Query_Help/SPARQL_Editor
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service/Implementation/Standalone
 * https://wordpress.horje.com/wordpress-wp-47443-wikidata-query-service-embeder.html
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Query_Helper

Technical references

 * https://wikitech.wikimedia.org/wiki/Wikidata_Query_Service (also a how-to)
 * https://wikitech.wikimedia.org/wiki/Wikidata_Query_Service/ScalingStrategy
 * https://en.wikibooks.org/wiki/SPARQL
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Wikidata_Query_Help
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Copyright
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Wikidata_Query_Help/Result_Views
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual/SPARQL_Federation_endpoints
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service/Implementation
 * https://doc.wikimedia.org/wikidata-query-rdf/query-service-parent/index.html

Source code and tickets

 * GitHub mirror: https://github.com/wikimedia/wikidata-query-rdf
 * https://phabricator.wikimedia.org/tag/wikidata-query-service/
 * Query UI subproject https://phabricator.wikimedia.org/project/view/2901/

Other / uncategorized

 * https://www.mediawiki.org/wiki/Wikimedia_Search_Platform
 * https://query.wikidata.org/
 * https://www.wikidata.org/wiki/Category:Generic_SPARQL_query_templates
 * https://github.com/wikimedia/WikidataQueryServiceR

Q & As

 * https://stackoverflow.com/questions/tagged/wikidata-query-service
 * https://www.quora.com/search?q=%22Wikidata%20Query%20Service%22

Query repositories/lists

 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/queries
 * https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/qotw
 * https://github.com/wikimedia/wikidata-query-rdf/blob/master/docs/sparql-query-examples.md
 * https://github.com/wikimedia/wikidata-query-rdf/tree/master/queries
 * https://www.mediawiki.org/wiki/Wikidata_Query_Service/Problematic_queries


 * https://blog.wikimedia.de/2016/10/30/10-cool-queries-for-wikidata-that-will-blow-your-mind-number-7-will-shock-you/

Tutorials

 * WMF - Querying Wikidata with SPARQL for Absolute Beginners https://www.youtube.com/watch?v=kJph4q0Im98&t=13s


 * Wikimedian in Residence - University of Edinburgh - Wikidata Sparql Query Tutorial https://www.youtube.com/watch?v=1jHoUkj_mKw


 * Wikicite 2017 - Day 2 - Tutorial: Wikidata, SPARQL, and WQS https://www.youtube.com/watch?v=XLlzTtozRY4

Explanation

 * Wikidata Query Service scaling challenges (WikidataCon 2021 recording) https://www.youtube.com/watch?v=1nZxY4r5KQs

How to

 * Building a simple web app using Wikidata data https://www.youtube.com/watch?v=G7ChC1pplik

Others

 * "Wikidata Live Querying" by Lucas Werkmeister https://www.youtube.com/watch?v=EA9sLTEdcSo&t=112s