-
Notifications
You must be signed in to change notification settings - Fork 12
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
Add guidelines for a good conference transparency report #13
Open
ambv
wants to merge
2
commits into
psf:main
Choose a base branch
from
ambv:transparency
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
45 changes: 45 additions & 0 deletions
45
docs/python.org/code-of-conduct/Transparency-Report-Guidelines.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
# Releasing a Good Conference Transparency Report | ||
|
||
Publishing a transparency report after the event concludes is a critical step for building trust within the community and ensuring the community that any issues that have been reported have been handled in an appropriate manner. | ||
|
||
This guide is provided for conference organizers. We particularly hope it is useful for Conference Chairs and Code of Conduct responders. | ||
|
||
In this document we're discussing the **public-facing** summary transparency report. For operational purposes, an event should also keep private records of all reports and issues at the event. | ||
|
||
|
||
## When to release | ||
|
||
A timely report helps everybody: | ||
|
||
- Reporters know that their reports were taken seriously; | ||
- Attendees can see that CoC reports are an integral part and so feel confident to attend in the future and report issues they themselves witness; | ||
- Organizers demonstrate strong commitment to follow their stated goals and procedures. | ||
|
||
Since it's important to be able to recall details of covered issues accurately, a timely report will be of higher quality. | ||
|
||
Releasing an initial transparency report should be part of the closing ceremony. Following up with affected parties might take time after the event. Therefore, a separate complete report can be provided in writing at a later time. It wouldn't take more than a month after the event to close the loop on the final report. | ||
|
||
|
||
## How to publish | ||
|
||
An initial **in-person report** during the closing ceremony is highly recommended. Any information available by that time, including statistics on the number of reports, will be very valuable to attendees at the event. Cases that need following up shouldn't block the initial report from being presented. | ||
|
||
After the event, any **official communication channel** used with the attendees is a good option for letting people know a transparency report is available. Examples include: | ||
|
||
- Official website for the event; | ||
- Official blog for the event and/or organization behind it; | ||
- Newsletter or mailing list(s) in use around the event. | ||
|
||
|
||
## What to include | ||
|
||
Starting with some general information about the event puts all data in context. Include **the size of the event**, with separate numbers for in-person and online attendees, if applicable. Briefly describe the **reporting process**: who the people enforcing the CoC and responding to reports were, how an attendee could report a CoC issue, and where this information was available for attendees to find. | ||
|
||
The main part of the report will be the **statistics of reports** received (including past 3~5 years historical statistics can be helpful for comparison) and the **report status / progress for each report**. | ||
|
||
If there was a post-conference survey asking attendees about their confidence in reporting issues, the results of that survey can be included in the following year's transparency report. | ||
|
||
|
||
## What **NOT** to include | ||
|
||
Make sure the transparency report does not include any sensitive information such as the names or any identifiable information of the reporters and the reported people. In the event that law enforcement was called, you should say they were called and not make further comments on the details as it could adversely affect official action. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
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.
My brain is tired, but my gut feeling is we should lean harder on recommending and suggesting using "should" and "would."
Something like, "We recommend including an initial transparency report as part of the closing ceremony."
I struggled with this sentence. It feels like something we should reword, "We recommend closing the loop on final reports within one month after the event when possible." If we are being 100% transparent here, we have seen reports from conferences take as much as a year or more to fully resolve.