-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Documentation for moderators #40
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for starting this!
|
||
1. Proficient in [R package development](https://r-pkgs.org/). | ||
1. Comfortable managing content on [GitHub](https://github.com) such as repositories, pull requests, issues, and discussions. | ||
1. Prepared to facilitate the [process to contribute packages to R-multiverse](https://r-multiverse.org/contributors.html). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
we need some written expectation of responsiveness, as this would help people assess whether they can help. For instance for rOpenSci software review for most things, we sort of expect answers within one week or so.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This seems trickier for R-multiverse because we don't have a system for explicitly delegating package reviews at https://github.com/r-multiverse/contributions or responses to questions at https://github.com/r-multiverse/help/discussions. Do we want to say that moderators and admins collectively as a team should respond within a week? Does this belong in https://r-multiverse.org/contributors.html instead?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe? My worry is that the docs for moderators have no rough estimate of the workload that the role would entail. Maybe there could be a rough estimate, and also the idea of a trial period after which the moderator can decide it's too time consuming?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What if the moderators tell us up front how many hours per week or month they can volunteer, and what they'd be willing to do? Some could stick to reviewing packages (or only certain kinds of packages) while others could just comb the help forums.
I think this right-sized approach can work because there are so many stopping places: there is very little to check when reviewing a package manually, and for a knowledgeable package developer, I think most reviews will end up taking less than 15 minutes. And they can always contact us for help on difficult cases. Feedback on the forums feels similar. By contrast, an rOpenSci package review is a serious investment of time and critical thinking, and it's either all complete or unfinished.
I think the expectation is that any leftover work will fall on the admins.
I have seen this low-pressure leave-anytime model work well for environmental volunteer groups.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would we need to record this information anywhere except the web form responses?
moderators.md
Outdated
1. If an R-multiverse package or [R-multiverse stakeholder](governance.md#r-multiverse-stakeholders) violates any applicable laws, | ||
contact the appropriate law enforcement agency. | ||
1. If an R-multiverse package on GitHub and violates any [GitHub policies](https://docs.github.com/en/site-policy), | ||
[report the violation to GitHub](https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
how would we keep track of individual reports?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I hadn't thought of that. Should we? IIRC rOpenSci has a code of conduct violation reporting policy, right?
The mechanism for blocking a package is writing free-form text in the package listing to explain the situation. I did this recently with DEPAHRI
because the package does not have a serious license and I did not hear back from the authors: https://github.com/r-multiverse/contributions/blob/main/packages/DEPAHRI. Do we need something more centralized, or something that doesn't require blocking a specific package?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What I mean is that if an individual moderator makes a report of a violation to GitHub, then how do other moderators know it's been done?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would a public GitHub discussion be enough? I think our governance promises open communication, which would point us to https://github.com/r-multiverse/help/issues and/or https://github.com/r-multiverse/help/discussions. From r-multiverse/help#77, it seems like @shikokuchuo may prefer not to make exceptions for these cases, and this is my view as well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes as long as this does not make the person who does the first report and tracks it a target of vengeance (a bit paranoid 😅)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think these docs should emphasize that a moderator can consult an admin if there is concern about whether or how to post a report.
Open reporting is valuable from a security standpoint: contributors and maintainers will hesitate to act maliciously if they know their actions will become public knowledge. I feel like this should be part of one of our policies somewhere. I will think about it and post a proposal.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added 7c1c4ff to edit the reporting guidelines:
Each incident, the actions taken to respond to the incident, and the resolution must be reported as an issue at https://github.com/r-multiverse/help/issues with the label "policy violation".
If you do not feel comfortable taking direct action yourself, contact an administrator immediately and ask the administrator handle the situation.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
On second thought, some types of policy violations require discretion. In particular, code-of-conduct-related matters can be sensitive. Maybe we need a separate confidential forum for this which includes moderators and admins.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just posted r-multiverse/help#117
moderators.md
Outdated
# Contact | ||
|
||
If you would like to be a [moderator](governance.md#moderator), | ||
please reach out to one of the [current Administrators](team.md#administrators). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should we have a group email address? which wouldn't prevent people from reaching out first to the one administrator they know best to ask questions.
I would prefer we do not merge this PR before we have a volunteering form (whose questions we'd make available outside of the form for those preparing answers in advance) as a free-text volunteering email is stressful and rather unfair as some people are better at this without this meaning they'd be better/worse moderators.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should we have a group email address?
I'm not sure. I actually like not having one because it nudges more of the communication out in the open.
I would prefer we do not merge this PR before we have a volunteering form
Happy to write one. How are these forms typically deployed?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
At rOpenSci we use Airtable, maybe (probably) the free plan could be enough for this. https://airtable.com/pricing
Alternatively there's Google Forms but not everyone likes Google.
These are just the ones I know.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Google Forms looks more convenient and easier to use. Do you have a preference?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Also, from https://r-multiverse.org/governance.html#communication:
Communication is always done publicly via GitHub, and all decisions related to the project are made in public.
An exception exists for confidential security and conduct-related matters, for which there is a private GitHub repository accessible by administrators only. The use of this private repository ensures that even confidential conversations remain accountable and auditable.
Do we also need to mention that survey responses and on-boarding issues for moderators will be confidential (only admins will know)?
Do we also want another confidential repo (e.g. https://github.com/r-multiverse/moderation) to track moderator-related matters? We could include a table of metadata on moderators there: hours volunteered and areas of expertise. Also could include confidential discussions about how to handle policy violations, on the grounds that the results will become public as soon as it is safe to do so. This way moderators could more easily ask for help from other moderators in addition to admins. And it's more auditable than a confidential moderator-to-admin email.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added 88c53cd to propose questions for the web form. I can create the form itself when we agree to merge this PR.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could include a table of metadata on moderators there: hours volunteered and areas of expertise.
Maybe we can avoid recording hours in a separate place? And track expertise and affiliations at https://r-multiverse.org/team.html?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Here are my comments based on my first read of the moderator documentation. I hope these are useful and please let me know if you have any questions or want to talk more about it.
Perhaps you already have but is a good idea to have an onboarding and offboarding issue with a check list of all the steps you and the moderator need to take in order to onboarding and offboarding them.
moderators.md
Outdated
Each incident, the actions taken to respond to the incident, and the resolution must be reported as an issue at <https://github.com/r-multiverse/help/issues> with the label "policy violation". | ||
If you do not feel comfortable taking direct action yourself, contact an [administrator](team.md#administrators) immediately and ask the [administrator](team.md#administrators) handle the situation. | ||
|
||
1. In case of an extreme policy violation, or repeated violations of the [code of conduct](conduct.md), |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is there a code of conduct committee? Is the CoC also reinforced by moderators? There is a process for reinforcing the CoC? How do moderators know when someone violates the CoC more than once?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
b3973ec references the enforcement policy in the code of conduct. Beyond that, I think CoC enforcement and general policy enforcement both need more planning. I will open an issue at https://github.com/r-multiverse/help/issues.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Posted r-multiverse/help#117
Thanks for the feedback! |
This PR adds documentation for moderators (c.f. r-multiverse/help#98)