Hello,
Thank you for this info. I share an interest in the maintainability of code that may be around for years, long after the people who write it are no longer involved with Wikimedia.
It sounds like the Code Health Group is effectively an internal special interest group for Wikimedia people (I am hoping that it isn't exclusive to WMF staff) who share an interest in "code health", but isn't a top-down decision-making body like TechCom. Is that correct?
One thing that I would like to request is a change of terminology. I prefer to reserve the term "first responder" in the Wikiverse for people who are actually on the front lines doing time-critical work, such as volunteer administrators and functionaries who address threats, harassment, and other issues with legal and security implications; WMF staff who respond to emergency@ tickets; and staff and volunteers who deal with urgent technical problems of various kinds and are on call 24/7 for that purpose. Accordingly, I would request that you replace your use of "first responder" with a different term; it's fine to use a term that sounds attractive, but preferably one that doesn't already have a different (and in this case, very important) meaning. Perhaps I'm excessively defensive and biased, so take my opinion with a grain of salt, but as someone who occasionally deals with certain issues on a 24/7 basis, I think that the term "first responder" should be reserved.
Thank you,
Pine ( https://meta.wikimedia.org/wiki/User:Pine )
On Wed, Oct 3, 2018 at 10:44 PM Jean-Rene Branaa jbranaa@wikimedia.org wrote:
Code Health Newsletter
The Code Health[0] newsletter is a monthly publication provided by the Code Health Group[1]. The Code Health Group serves as the hub for all Code Health topics and activities within the movement. If you are aware or engaged in Code Health activities, we'd love to hear about it.
# First Responders
Staying with the Health theme, First Responders[2] are those individuals that have made strides in improving their code's health. These efforts will hopefully act as stories of inspiration for others to take on improving their code's health.
Do you have a story to share? Become or nominate a First Responder by submitting a task in Phabricator in the #Code-Health-First-Responder project. If sharing inspiration isn't enough, how about a cool free First Responder t-shirt (more about that coming soon).
# Code Stewardship
Code Stewardship[3] is an approach that the Wikimedia Foundation has adopted to help ensure that components, extensions, and services that are deployed to the production infrastructure have the necessary support throughout their lifetime.
To date, the Code Stewardship review process[4] has helped identify and find Code Stewards for 10 components, extensions, or services that were un/under-supported. The goal is to have complete Code Steward coverage for all deployed-to-production components, extensions, and services. Although we are not there yet, we are working towards that goal every day.
This quarter's review window has closed. More information about how to submit a review candidate is available on the Code Stewardship review process wiki page[4].
Latest Code Stewardship Coverage
Core Components: 63% Extensions: 74% Services: 65%
Note: these numbers are based on the Developers/Maintainers[5] page.
# Code Health by the Numbers
The following are some stats regarding Code Health. As we are early in defining/implementing our Code Health metrics, data is limited. See the Code Health Metrics project[6] for more information.
In future issues of the newsletter, we'll expand this section to include other metrics as well as trending information.
## Code Coverage
0-50% 51-90%
90-100% _______________________________ Extensions 71 13 4 Code Components 5 10 18 Services Not Available Yet
Note: As of 9/30/18[10].
# Code Health Learning Circles
Learning Circles are an effective way to share knowledge and experience with your peers. Although Learning Circles have been done in one form or another for quite some time, we've decided to do our best to promote more Code Health related sessions. More information about Code Health Learning Circles available here[6].
If you have a topic that you'd like to share, but want a little help with organizing, please submit a Phabricator ticket to the #Code-Health-Learning-Circles project.
Newly Added:
Topic: Design Principles and Code Refactoring Presenter: Guillaume Lederrey Link: https://commons.wikimedia.org/wiki/File:Learning_Circle_CodeRefactoring_Guil...
#Code Health Group Activities
Although the Code Health Group looks to act as a hub for all code health topics, the group also sponsors various broader reaching initiatives.
Recent Activities:
Code Health Metrics
Code Health Metrics[7] working group has been formed. This working group will focus on defining a core set of metrics that we can use to assess code health. If you're interested in Code Health metrics please engage in the discussion on the Discussion page[8] and/or IRC #wikimedia-codehealth.
Up Coming Activities:
Code Health Office Hours
The Code Health Group is sponsoring a new bi-weekly Code Health Office Hours starting October 16th at 3:00pm (15:00). These sessions are to be held in Goggle Meet[9].
#Help Wanted
Do you have a Code Health topic that you need help with? Advice about refactoring, tech debt, unit testing, etc... This is the place to ask for it. Please submit a Phabricator task to the #Code-Health-Help-Wanted project and the Code Health Group will do its best to point you in the right direction.
# Summary
That wraps up this inaugural issue of the Code Health Newsletter. If you have any suggestions and/or want to see other topics, feedback is welcome. Please just reply to this email.
Cheers,
JR
[0]https://www.mediawiki.org/wiki/Code_Health [1]https://www.mediawiki.org/wiki/Code_Health_Group [2]https://www.mediawiki.org/wiki/Code_Health/First-Responders [3]https://www.mediawiki.org/wiki/Development_policy/Code_Stewardship [4]https://www.mediawiki.org/wiki/Code_stewardship_reviews [5]https://www.mediawiki.org/wiki/Developers/Maintainers [6]https://www.mediawiki.org/wiki/Code_Health_Group/Learning_Circles [7] https://www.mediawiki.org/wiki/Code_Health_Group/projects/Code_Health_Metric... [8] https://www.mediawiki.org/wiki/Talk:Code_Health_Group/projects/Code_Health_M... [9]https://meet.google.com/umj-usbi-sjk [10]https://doc.wikimedia.org/cover/
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l