Page MenuHomePhabricator

admin docs: quarry
Open, LowPublic

Description

I created the other day administrator documentation for the Quarry data service by the WMCS team.

https://wikitech.wikimedia.org/wiki/Portal:Data_Services/Admin/quarry

I'm opening this task for reviewing and polishing the wiki page.

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptOct 10 2018, 10:19 PM
aborrero renamed this task from admin doc,./' to admin docs: quarry.Oct 10 2018, 10:21 PM
aborrero assigned this task to srodlund.
aborrero triaged this task as Low priority.
aborrero added a project: Documentation.
aborrero updated the task description. (Show Details)

Hello @aborrero and thanks for trying to take care of it. It was in my to-do list.
Is it a doc from/for the team ? or maintainers (me and @zhuyifei1999) can/are invited to edit it, to avoid duplicating this page ? If yes, would it be possible to rename it to something like https://wikitech.wikimedia.org/w/index.php?title=Nova_Resource:Quarry/Admin ? Thanks !

Hello @aborrero and thanks for trying to take care of it. It was in my to-do list.
Is it a doc from/for the team ? or maintainers (me and @zhuyifei1999) can/are invited to edit it, to avoid duplicating this page ? If yes, would it be possible to rename it to something like https://wikitech.wikimedia.org/w/index.php?title=Nova_Resource:Quarry/Admin ? Thanks !

Hey @Framawiki you are more than welcome to edit the page :-) thanks for your contributions BTW.

Regarding the URL: I understand this is an Cloud VPS project, but it's also a service ''offered'' to the movement as part of the Data Services effort.
We would like to keep things sorted (specially admin docs) in the /Admin section of each service offered (so you can eventually reach the docs from the front page).

May I suggest you to do the other way around? To put a link in https://wikitech.wikimedia.org/w/index.php?title=Nova_Resource:Quarry/Admin pointing to https://wikitech.wikimedia.org/wiki/Portal:Data_Services/Admin/quarry

Oh, I didn't know "Data Services" was "offering" service to the movement. It can be great to specify in the project page and its footer that it's an official WMF site. If there's an assigned team and assigned professional programmers, that's cool! It might be nice to start with T205150: Develop the monitoring of Quarry, and there will also be localization and unit tests to get a "real" program.
:-)

It's part of Data Services because of Yuvi I think :) And Quarry has so many users that it's almost production-like.

WMF researchers / analytics like halfak and milimetric has been helping with this project before I did, but no assigned teams or anything so professional like that.

I think the admin docs here are in the case that if the cloud services team needs to break/fix anything fast, they can help themselves, without waiting for us to do them.

I was a bit trolling in my last comment of course.
But ie. T205150: Develop the monitoring of Quarry is an essential task, that involve WMF peoples (join prod instance, labs one ?) and creating a monitoring tool is not at the scope of Quarry project. Help would really be needed here.