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(a)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_Gui…
#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_Metri…
[8]
https://www.mediawiki.org/wiki/Talk:Code_Health_Group/projects/Code_Health_…
[
9]https://meet.google.com/umj-usbi-sjk
[
10]https://doc.wikimedia.org/cover/
_______________________________________________
Wikitech-l mailing list
Wikitech-l(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l