Description
The following proposed text would form the basis of a DMTN by the DM-SST, and also be posted to community.lsst.org to increase circulation to DM staff and community science members. A preliminary review of this text has been completed already by the DM-SST, and we now solicit additional feedback.
Interim Model for Community Support During Construction
This document aims to bring interactions between the Rubin Data Management (DM) construction staff, including the DM System Science Team (DM-SST), the Rubin pre-Ops Community Engagement Team (CET; described below), and the broader science community into alignment regarding community support. The goal is to strengthen both our interactions and our online resources by making consistent use of the tools at hand to support our combined efforts to develop, understand, and apply the the Rubin software and data products.
Community Forum
Our online Community Forum (community.lsst.org), has a wide variety of topical categories that serve the DM and science communities. Using the Community Forum for interactions between DM staff and science community members ensures that the information exchanged remains publicly accessible in this searchable forum, which reduces redundancy in all our interactions and helps us to build a strong user community with the means to help itself. Towards these goals, questions about Rubin software and data products should be directed to the Community Forum, and we all should aim to discuss and provide answers there (instead of via Slack or email).
There are two main categories dedicated to hosting questions from the community to DM: “Support” and “Science - Data Q&A”. The former is typically populated with questions about the current Rubin software, and the latter with questions about the planned data products. These two categories are full of excellent examples of Rubin DM staff responding to community requests for support and working to resolve the issues. The “Science - Data Q&A” category has been moderated by the DM-SST, whereas assistance in the “Support” channel has occurred more organically. Going forward, the DM-SST will take a more active role in helping to moderate the “Support” channel as well, to ensure no question goes unanswered. The hope is that this additional DM-SST involvement will encourage all members of DM and the science community to direct questions to the Community Forum.
Furthermore, when DM staff encounter issues or have internal Q&A which could be of broader interest, posting it to the Community Forum is encouraged. The DM-SST and the CET are happy to assist with distilling and formatting such posts (contact Melissa Graham). This Community Forum post about DIA Objects in the AP and DR catalogs (link) is a good example of a discussion that occurred in Slack, but was deemed to be of broader interest and moved to the Community Forum, and for which a distilled summary was prepared.
After the Rubin Construction phase ends and Operations begins, the CET will be the main interface for project-community interactions and will assume responsibility of moderating user support in the Community Forum. In this interim phase, the CET will work with the DM-SST to assist with responding to requests for user support in the Community Forum. Both the DM-SST and the CET will rely on existing documentation to generate answers when possible, and identify expertise among DM staff to assist on an as-needed basis. This means that they might solicit DM expertise via Slack channels or by contacting individuals directly; DM staff should review the “Jira” section below.
LSSTC Slack
The LSSTC Slack is our tool for conversations across our geographically distributed network, with many channels hosting active participation of both DM staff and community members. As two examples, the #dm-[x] channels are focused on active code development by DM staff in which community members are welcome to follow and participate in the discussions, and the #desc-[x] channels are focused on DESC activities and encourage participation of DM staff with overlapping science interests.
The wide variety of channels and generally casual nature of Slack make it very useful for on-the-fly conversations, but these aspects can also make it challenging for new users from the science community to navigate. The hope is that clearly and unambiguously identifying the Community Forum as our primary tool for community support will reduce barriers to participation. Towards this end, everyone is tasked with being proactive about directing questions (and especially requests that could be categorized as “user support”) regarding Rubin-developed software or data products out of Slack and into the Community Forum, as often as possible. It is appreciated that the identification of what is appropriate for Slack vs. Community Forum is a grey area, especially during this interim phase, so let’s apply the principle that no topic is inappropriate for the Forum.
It is anticipated that a casual channel for real-time conversations about Community Forum postings will be both needed and useful, at least during this interim phase. The open channel #dm-support should be used for this because it is already the Forum-Slack interface (all new Forum postings in “Support” or “Science - Data Q&A” appear in #dm-support).
Jira for DM Staff
There will be cases where difficult questions are posted to the Community Forum, or the ensuing discussions reveal bugs or desired new features. These cases might require scheduled work on behalf of DM staff to generate an answer. This work should be done with Jira tickets to ensure it is trackable and accounted for. All DM staff should be sure to talk to their T/CAM if a support-related activity requires such work.
Community Engagement Team
The Rubin Observatory Community Engagement Team (CET) within the System Performance department will be responsible for providing support for science users of Rubin data products and services during Operations. For example, by enabling crowd-sourced problem solving, curating documentation and tutorials, serving as an interface between project and community, and coordinating expertise to respond to issues that may arise. Now, during pre-operations, the CET is making plans for a full community support model and beginning to take on some initial responsibilities. To start, all CET members will join #dm-support, help to monitor postings to the Community Forum categories “Support” and “Science - Data Q&A”, and assist when possible with responding to questions. The role of the CET will continue to evolve during pre-operations.
Feedback to the CET regarding the use of the Community Forum and Slack for community support is solicited from members of both the project and the community.
Attachments
Issue Links
- is triggering
-
DM-25669 Contribute to the interim community support model
- Done
-
DM-25670 Contribute to the interim community support model
- Done
-
DM-26765 Update developer guide to reference the interim model for community support
- Done
- mentioned in
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
-
Page Loading...
I am not part of the CE team, but I have done user support in one way or another all my adult life and manage one of the most user-intensive services at Rubin so I ask for your indulgence to make some comments, bearing in mind that is is ultimately Leanne's call as it is her department.
A successful endeavour requires the optimal application of resources. Optimal does not mean best for every single individual (as that is usually as possible as perpetual motion), but best bang for your buck, and the buck here is the attention economy of the project staff. To give a non-computing example: if you are teaching an 800-student strong Astronomy 101 course, you are not telling your students "drop by any time if you ever have a question". That would be best for the student, but it is not best for you, and you are over-leveraged, which is why you have sign-ups for office hours.
So while for any individual it would be best if they can drop into our Slack and get the full attention of several people, with 8,000 users and a handful of developers that is an attention economy dumpsterfire. There is a reason why you don't get support from Amazon, or your congressperson or even your doctor on an interactive chat system.
Not only is chat a denial of service attack to highly leveraged staff but it is actually terrible for knowledge transfer. Anybody who has watched the endless goldfish bowl that is Twitch chat can vouch to that
A user getting their questions answered does nothing to help the user 3 months later with the same question. Yes, Meredith's point that this helps support staff know what questions are asking is valid, but the same thing would happen if they had asked it on a web forum.
Now academia has a great tradition of self-organising support and collaboration communities (exhibit A, science collaborations). When we at SQuaRE first made a community web forum (colloquially CLO) platform available, one of its two express purposes was to divert support to a googlable forum, so the next user could find the answer without even asking. But note that in those days chat platforms like Slack had a very locked in organisational model and we also wanted the one strong technical advantage of chat: when you do need to engage a user in a tight troubleshooting loop ("what happens when you type this? what about that?") Slack really is better for everyone.
Meanwhile, the world has evolved. Slack has made it very easy to make and to belong to multiple workspaces (something that was impossible in the beginning IIRC), to invite guests into channels and so on. Moreover, as other parts of DM have come along, more of us are deeply involved in systems with no front-facing external user interactions and have larger codebases to support. We are not Amazon or Facebook, but we do have the need to scale support to a level where some of their user support modalities are more appropriate to us in some cases.
Finally, and I hope I don't make any enemies with this one, I include my own systems in them: "boutique" level support is a crutch. Helping someone on Slack at 10pm makes me feel good and like I did something useful and I go to bed happy with the praise of the grateful user, but what I really should have done is made sure the code was not flakey or the class design confusing, or the documentation lacking in the first place. I feel good when I should have felt bad.
I understand the current system seems to work well, and I am happy people are getting help on #newbies, but consider also the severe downsides to the current model:
Okay so if anybody made it past these ramblings:
FWIW, if I was dictator of the earth, I would