[Hackathon doc sprint] Wikibase installation
Open, NormalPublic

Description

This is one of the main topics of the Wikidata documentation Sprint during the Wikimedia Hackathon 2017.

Feel free to add in subtasks your ideas of tasks to improve the documentation for people who want to install their own Wikibase instance.

The tasks should be:

  • Simple (you can split complex tasks in several tasks)
  • Clear (please add details, links, explain what's wrong or missing in the existing doc)
  • Ideally, feasible by a team in maximum 1 day

Links to Wikibase doc (feel free to add more):

Inspirations (nice doc from other projects):

  • ...

For the usecase "install wikibase" we don’t necessarily shine:

  • Use a major search engine with "wikibase", go to https://www.mediawiki.org/wiki/Wikibase
    • The page offers almost no description, looks like no one cares for it.
    • User needs: …to klick the link to wikiba.se
    • Possible task: Offer brief info, a screenshot and a easy to find link to wikiba.se (or just provide all there?)
  • Look at wikiba.se
    • There is no info for common usecases like "using the client as a user" or "install"
    • User needs to: …first choose if one wants client or repo
    • Possible task: provide info that leads to installation and/or use docs. I assume, you first need a repo. In this case it should be somewhat standard.
  • Look at more info on the repo
    • There is no info for common usecases like "using the client as a user" or "install"
    • …but at least a download link
    • User needs to: Klick the download link
    • Possible task: again, clearer info for usecases like install
  • Now I’m back to mediawiki?! https://www.mediawiki.org/wiki/Extension:Wikibase_Repository#Download
    • I get the git template which has many options, only some somewhat related to download
    • I should either select an branch or
    • checkout via git
    • Possible tasks: The git template could be improved or we provide a section without it
Jan_Dittrich added a comment.EditedMar 7 2017, 1:27 PM

Related:

  • [Task] improve documentation of wikiba.se infrastructure – T99530
  • Actions to grow the diversity of our technical community – T148598
Lydia_Pintscher moved this task from incoming to monitoring on the Wikidata board.Mar 23 2017, 2:46 PM

Hello! Just letting you know that you can schedule this session now for the hackathon. Instructions and scheduling can be done here:
https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2017/Program#How_to_schedule_breakout_sessions

Tarrow added a subscriber: Tarrow.May 16 2017, 11:24 AM

I've put up an updated and enhanced version of https://www.mediawiki.org/wiki/Wikibase on https://www.mediawiki.org/wiki/User:Tobias_Gritschacher_(WMDE)/Wikibase.

As I see it and @Jan_Dittrich pointed out, the page serves as kind of an entry point when people are interested in Wikibase. So, it should give an overview of what Wikibase is as well as some basic information what you're able to with it. Additionally, people might be interested to set it up for their own wiki, so the page should provide a link to the installation guide.
@Jan_Dittrich @Lea_Lacroix_WMDE @Lydia_Pintscher feel free to review/change my version of the entry page - I'll replace the current version of the page with the new one closer to the end of the hackathon.

Next step for me: trying to come up with a basic step-by-step installation guide for setting up Wikibase Repository (T164465).

Can do minor improvements or is it already in translation?
One open question I still have is what the "current" version of Mediawiki and Wikidata is – the master? Any sort of "beta"? Or is it just called "current Version" everywhere?

@Jan_Dittrich You can. I'll mark for translation later during the day.

@Jan_Dittrich yes it's master. Changed the text a bit to clarify this,

johl reassigned this task from johl to Tobi_WMDE_SW.May 21 2017, 10:01 AM
johl added a subscriber: johl.