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