Page MenuHomePhabricator

Create summary templates on Wikitech wiki to stop writing the same things everywhere, everytime
Open, LowPublic

Description

wikitech documentation has A LOT pages containing tips and warnings about two "special" things:

  • deploy / ask SWAT / ping greg if emergency / never the Friday or the week end excepted if there is an emergency / ask one of the 21 deployers
  • dba / schema changes / we don't run update.php / file a DBA ticket / ping jynus

These sections have too details, details outdated, like "SWAT is twice a day".

The maintenance cost of these page is terrible.

But we've to acknowledge people seems to want to write this kind of summaries instead to only link to these pages.

So what could help is small templates, six to eight lines max to transclude with the big picture.

That will ease maintenance cost to have only one summary to maintain.

Then we can replace all the sections dba/deploy code specific to use these templates.

Event Timeline

Dereckson removed Dereckson as the assignee of this task.May 19 2017, 1:36 PM
Dereckson created this task.
Dereckson updated the task description. (Show Details)
  1. Note: Dereckson did some of this in:

https://wikitech.wikimedia.org/wiki/Template:Ask_deployment/code
as used in e.g.
https://wikitech.wikimedia.org/wiki/How_to_deploy_Wikidata_code#Deploy_a_hotfix
but it looks like it needs to be propagated to other pages still? Or are you waiting for feedback from someone?

  1. @Dereckson If you list some example pages/sections, we may be able to help templatize the other repetitive bits?
jcrespo renamed this task from Create summary templates to stop to write the same things everywhere everytime to Create summary templates on Wikitech wiki to stop to write the same things everywhere everytime.Jun 19 2017, 11:22 AM
jcrespo renamed this task from Create summary templates on Wikitech wiki to stop to write the same things everywhere everytime to Create summary templates on Wikitech wiki to stop writing the same things everywhere, everytime.
jcrespo lowered the priority of this task from Normal to Low.Sep 12 2017, 4:28 PM

I am not saying this is not important, but nothing will break if this is not done (unlike many other "normal" tickets), which for me is low prioriy. Feel free to put it higher if you can help with this.

jcrespo moved this task from Triage to Backlog on the DBA board.Sep 12 2017, 4:29 PM