Michael added a comment.

  @lucamauri Your feedback is very welcome and helpful. Thank you!
  
  In T218282#5114315 <https://phabricator.wikimedia.org/T218282#5114315>, 
@lucamauri wrote:
  
  > - If this is the right place to add the text depends on what we consider 
//Standard// and //Advanced// configuration. I agree to put this specific text 
where you suggest to, but then I am not sure any longer if it make sense to 
have two separate installation instructions page, instead of one well-organized 
one
  
  
  Yes, I intended to prune the other "Advanced" config to remove duplication. I 
suggested adding this content to the main installation page, because the Item 
pages feel actively broken/incomplete without it, since the sitelinks are such 
a large section on the Item page.
  
  > - The candidate documentation in my opinion fails to explain the user the 
concepts behind. As I wrote above, I consider this of paramount importance. The 
paragraph is titled `Enable SiteLinks`, but nowhere is explained what a 
"SiteLink" is or what relation has with "Direct Access". In the brief 
introduction I wrote, those terms were at least referenced and linked
  
  Yes, some introduction is a good idea. I would like to focus here more on 
getting the sitelinks on the Item pages to work and have a guide about Direct 
Access on the advanced config page or somewhere else.
  
  > - Are we sure that `Extension:WikimediaMessages` must be installed to edit 
messages? In my installation I was able to modify them by simply editing the 
page `MediaWiki:Wikibase-sitelinks-yourgroupnamehere`
  
  No, `Extension:WikimediaMessages` is only needed if one wants to use the 
default/example settings. Apparently, I should phrase this clearer. Or maybe 
drop it completely, because 3rd Party installations will likely never use it.
  
  > - I would move `$wgWBRepoSettings` //after// the instructions about Sites 
(if not, //above// and //below// must be adapted)
  
  I moved it towards step 1, because I find it important to think about the 
desired structure in the sidebar //before// adding sites to the table, as 
changing the sites table again afterwards can be annoying. But you are right, 
when incorporating your lines I missed adjusting some words. Will fix :)
  
  > - It seems to me that using `Special:SetSiteLink` is less user-friendly 
than setting the SiteLink in the related box in the item's page
  
  True, I mainly intended it as a verification step, as the SiteLink widget in 
the related box in the item's page can give for some problems no error message 
at all. However, you are very right as far as everyday usage is concerned.
  
  > - I think the wiki where //Repository// is installed should be referenced 
in a clearer way in respect to simply //your wiki//: as we are always talking 
about wikis, I am not sure it is clear to the users what is the //consumer// 
and what the //consumed// one
  
  Good point, I will make this clearer.

TASK DETAIL
  https://phabricator.wikimedia.org/T218282

EMAIL PREFERENCES
  https://phabricator.wikimedia.org/settings/panel/emailpreferences/

To: Michael
Cc: Ladsgroup, johl, 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
[email protected]
https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs

Reply via email to