lucamauri added a subscriber: Addshore. lucamauri added a comment.
Please allow me another comment after @Addshore edit above. My personal impression with the documentation is that it is too directive without really explaining: the user is guided doing several tasks one after the other, but there is no explanation on what the user is actually doing and how this would reflect in the Wikibase operations. For instance, as we are discussing here, the user is told to run `populateSitesTable.php` but nowhere is explained //what// the `sites` table contains and what sites are added via this script. If a user is setting up a custom Wikibase installation, most likely this "standard" sites are not even necessary at all. What I tried to do adding the instructions here https://www.mediawiki.org/wiki/Wikibase/Installation/Advanced_configuration#Direct_access_and_SiteLinks was to share a procedure as much as explaining //why// the procedure must be done and //what// result the user will get eventually. As a newcomer to Wikibase, I found the most difficult thing being not understanding the general principles of the extension, before actually make it work. For instance, again, nowhere was //explained// what //Sitelinks// are and what is their relation with the //Direct Access//: after I grasped the way it actually functioned, doing the configuration ended up being the easiest part. My two cents at the end of the day, so, are: let's review the documentation //first// explaining the user how Wikibase works, //then// helping the user set it up to work like he would. TASK DETAIL https://phabricator.wikimedia.org/T218282 EMAIL PREFERENCES https://phabricator.wikimedia.org/settings/panel/emailpreferences/ To: lucamauri Cc: Addshore, lucamauri, Aklapper, Lea_Lacroix_WMDE, Lydia_Pintscher, alaa_wmde, Nandana, Lahi, Gq86, GoranSMilovanovic, QZanden, LawExplorer, _jensen, rosalieper, Jonas, Wikidata-bugs, aude, Mbch331
_______________________________________________ Wikidata-bugs mailing list Wikidata-bugs@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs
