lucamauri added a comment.

  In T218282#5107406 <https://phabricator.wikimedia.org/T218282#5107406>, 
@Michael wrote:
  
  > Please have a look at the draft at 
https://www.mediawiki.org/wiki/User:Michael_Gro%C3%9Fe_(WMDE)/WikibaseSiteLinksDoku
 . This draft is intended to be added to 
https://www.mediawiki.org/wiki/Wikibase/Installation as a same-level headline 
after the `Verify your installation` section.
  >
  > Please check if
  >
  > - the text is easy to understand and follow
  > - you consider this the right place to add it
  > - the text fulfills the acceptance criteria as defined above.
  
  
  Dear @Michael ,
  thanks for your effort and thanks for using some of my contributions for the 
instructions you wrote. I reviewed your text and following please find my 
considerations:
  
  - 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
  - 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
  - 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`
  - I would move `$wgWBRepoSettings` //after// the instructions about Sites (if 
not, //above// and //below// must be adapted)
  - 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
  - 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
  
  I am surely biased here – and this is the reason I would be glad to see other 
contributions as well – but I still find the instructions more linear and 
informative the way I originally wrote them. Please bear in mind that I started 
as an absolute beginner of Wikibase, so the documentation I wrote is the result 
of the process of learning how to configure Wikibase starting from scratch and 
formalizing Wikibase concepts by induction.

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

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

To: Michael, lucamauri
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