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://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

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/

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

Technical references

 * https://wikitech.wikimedia.org/wiki/Wikidata_Query_Service (also a how-to)
 * 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

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

Query repositories

 * 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