Infrastructure/Debt/2016/March

At Flock 2015, we started talking about instituting periodic events where we would stop working on new features and bugfixes, and work instead on addressing technical debt. The discussion continued in November and we had our first one in the first week of January, Tuesday through Friday, January 5th-8th.

We assessed that experience and decided to do a second one, this time more focused on just documentation. Currently scheduled for March 8th through March 14th 2016.

We're going to have a brief sync-up meeting in #fedora-admin every day that week at 16:00 UTC.

Things to work on

• Our wiki space
• The infra-docs repo (the SOPs) at https://infrastructure.fedoraproject.org/infra/docs/
• CSI vars in the ansible repo.
• Diagrams for how some applications work (badges, bodhi, pagure, bugyou, etc..)
• Inline code comments in any of our applications.
• Dig through all our ticket trackers looking for old docs-related requests we haven't been able to get to.
  • find and clean up any references to puppet in infra-docs -- https://fedorahosted.org/fedora-infrastructure/ticket/5128
  • SOP for FMN missing -- https://fedorahosted.org/fedora-infrastructure/ticket/4525

• Review and test new docs written by others.

Meetings

• https://meetbot.fedoraproject.org/fedora-admin/2016-03-08/infra_tech_debt_week.2016-03-08-16.02.html
• https://meetbot.fedoraproject.org/fedora-admin/2016-03-09/infra_tech_debt_week.2016-03-09-16.03.html
• https://meetbot.fedoraproject.org/fedora-admin/2016-03-11/infra_tech_debt_week.2016-03-11-16.04.html

Progress

Add links to things that got done here:

• badges.fedoraproject.org
  • https://github.com/fedora-infra/fedbadges/pull/48
  • https://infrastructure.fedoraproject.org/cgit/infra-docs.git/log/badges.rst
• pagure
  • https://pagure.io/pagure/pull-request/810
• FMN
  • https://github.com/fedora-infra/fmn/pull/124
• wiki:
  • https://fedoraproject.org/w/index.php?title=Infrastructure&diff=prev&oldid=438326
  • https://fedoraproject.org/w/index.php?title=Infrastructure/Officers&diff=prev&oldid=438328
  • https://fedoraproject.org/w/index.php?title=Infrastructure_Licensing&diff=prev&oldid=438335
  • https://fedoraproject.org/w/index.php?title=Infrastructure/CommonProblems&diff=prev&oldid=438336
  • https://fedoraproject.org/w/index.php?title=Infrastructure_Apprentice&diff=prev&oldid=438346
  • https://fedoraproject.org/w/index.php?title=Infrastructure/GettingStarted&diff=prev&oldid=438348
• bugyou
  • https://github.com/sayanchowdhury/bugyou/pull/1
  • https://github.com/sayanchowdhury/bugyou/commits/docs
  • https://bugyou.readthedocs.org/en/docs/
• SOPs
  • https://infrastructure.fedoraproject.org/cgit/ansible.git/commit/?id=04f65ea26fb41817d10c3d09ba490025c400659b
  • "Some minor tweaks to 2-factor sop" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=b9a590b32a4f9079bb74022b2393f5ca1122d996
  • "Update ansible sop" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=e5751c7ed2127e288ff680aa2ce32b4a1ff6264e
  • "Update apps-fp-o doc" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=23473e8a91c4c9e7b0b48528a645debc24788e99
  • "Update arm sop" seconds ago https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=14247a94dbbd12f1ab4537881a64b6b662868a53
  • "All of these things are gone and dead and we don't use them anymore." https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=2973051a23d9008373d92cb5c1a0256e12e9c979
  • "Add note about bastion-comm01 and clean up sop" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=1ba7f1d4317bf44cf3c3d6069590abd6fbce5206
  • "Minor tweaks to contenthosting" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=a0eedf908fb6a1e015c51e815ce078ff5e99fa5b
  • "We haven't had to do this in years, nuking it" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=e6df8c385a9f26aebbbe79727bdd4e7a82fbcd3d
  • "Update README" https //infrastructure.fedoraproject.org/cgit/infra-docs.git/commit/?h=master&id=4f4e000a1e35dcc4a9bd3e54689da84250555c94

• • Nuancier SOP up for review: https://fedorahosted.org/fedora-infrastructure/ticket/5155
  • kerneltest-harness SOP up for review: https://fedorahosted.org/fedora-infrastructure/ticket/5153
  • fedora-gather-easyfix SOP up for review: https://fedorahosted.org/fedora-infrastructure/ticket/5160