diff --git a/antora.yml b/antora.yml index 7f67489469e017d88288c185ea24528664161efd..223e2de4e60860ad4b8720a905d6c87ccb3bc275 100644 --- a/antora.yml +++ b/antora.yml @@ -21,4 +21,5 @@ start_page: ROOT:index.adoc nav: - modules/ROOT/nav.adoc - modules/events/nav.adoc +- modules/flock/nav.adoc - modules/participate/nav.adoc diff --git a/modules/flock/assets/images/pretalx-account-invite.png b/modules/flock/assets/images/pretalx-account-invite.png new file mode 100644 index 0000000000000000000000000000000000000000..2591dc44290a6ccb38a9f6ec73b09a3868cdad20 Binary files /dev/null and b/modules/flock/assets/images/pretalx-account-invite.png differ diff --git a/modules/flock/assets/images/pretalx-invite-acceptance.png b/modules/flock/assets/images/pretalx-invite-acceptance.png new file mode 100644 index 0000000000000000000000000000000000000000..b590d145d07f4eee627257671ca6d9054ea7efcb Binary files /dev/null and b/modules/flock/assets/images/pretalx-invite-acceptance.png differ diff --git a/modules/flock/assets/images/pretalx-reviewer-dashboard.png b/modules/flock/assets/images/pretalx-reviewer-dashboard.png new file mode 100644 index 0000000000000000000000000000000000000000..f674bd51d84579c8f0c64e4407dd36840cc9f393 Binary files /dev/null and b/modules/flock/assets/images/pretalx-reviewer-dashboard.png differ diff --git a/modules/flock/nav.adoc b/modules/flock/nav.adoc new file mode 100644 index 0000000000000000000000000000000000000000..ccc3bc71967f2b96c4f4555bcd25eee09564e09f --- /dev/null +++ b/modules/flock/nav.adoc @@ -0,0 +1,3 @@ +* Flock to Fedora +** xref:cfp-reviewer-guidelines.adoc[CFP reviewer guidelines] +** xref:cfp-pretalx-reviewer-guidelines.adoc[Pretalx CFP Reviewer Guide] diff --git a/modules/flock/pages/cfp-pretalx-reviewer-guidelines.adoc b/modules/flock/pages/cfp-pretalx-reviewer-guidelines.adoc new file mode 100644 index 0000000000000000000000000000000000000000..ce25346ac474e82ae44c5b6609b62ee4c1d49c47 --- /dev/null +++ b/modules/flock/pages/cfp-pretalx-reviewer-guidelines.adoc @@ -0,0 +1,76 @@ +include::ROOT:partial$attributes.adoc[] + += Pretalx CFP Reviewer Guide +Oluwatosin Olatunji; Justin W. Flory + +____ +Thank you for contributing as a reviewer for Flock to Fedora! +Your expertise is vital in shaping an outstanding conference experience. +This guide is designed to streamline your navigation of the Pretalx review process for Flock. +____ + +This page provides guidance to call for proposal (CFP) reviewers for the https://flocktofedora.org/[Flock to Fedora] conference. +CFP reviewers are invited by core Flock organizers as volunteers to help curate diverse content and programming at our contributor conference. + +[IMPORTANT] +==== +Your feedback should be constructive, insightful, and focused on the content of the submissions. +Your role plays a significant part in ensuring a high-quality experience for Flock. +==== + +This guide is organized into multiple sections below. + + +[[account]] +== Reviewer account access + +You will receive an invitation from a Pretalx administrator with login instructions. +You will be prompted to create a reviewer profile if it is your first time. + +.Email invitation from Pretalx +image::pretalx-account-invite.png[Screenshot of the email invitation sent by the Pretalx system to the user's email inbox. The email subject reads, "You have been invited to an organiser team".] + +.Accepting the invitation on Pretalx +image::pretalx-invite-acceptance.png[Screenshot of the dialogue to accept the email invitation to join a Pretalx team. Two options are presented to accept, to either sign in with an existing account or create a new one.] + + +[[proposals]] +== Proposal access + +Upon logging in, your dashboard will display a list of proposals assigned to you for review. +Also note that depending on settings, reviewers will be able to view and review all proposals, or only assigned proposals (determined by the Pretalx administrator). + +.Reviewer dashboard in Pretalx +image::pretalx-reviewer-dashboard.png[Screenshot of the reviewer dashboard from Pretalx. Four panes are shown: 5 proposals, 6 submitters, 1 review, and 1 active reviewer.] + + +[[review]] +== Review proposals + +A Pretalx proposal submission is typically composed of a title, abstract, track, theme(s), a brief speaker bio, and other notes. +If blind review for reviewers is enabled, speaker identities are hidden. + +All reviewers can give up to four points to a session. +Each point is weighed on a different criteria, much like a rubric. +The four point categories guide each reviewer to reflect on four different aspects of the proposal: + +. *Submission Quality*: + The basics. + Is the proposal well-written? + Is it thoughtful? + Does the speaker adequately describe their topic in a way that others can understand? +. *Theme Relevance*: + All proposals link themselves to one or many of the https://communityblog.fedoraproject.org/flock-2024-cfp-until-april-21st/[six themes]: + Accessibility (a11y), Reaching the World, Community Sustainability, Technology Innovation and Leadership, and Ecosystem Connections. + Does the connection between proposal and theme make sense? + Is it a good fit? +. *Probability of Success*: + Is the speaker adequately prepared to deliver their content? + If they will run a workshop, will it connect to the Flock audience and attendees? + If they present a session, do they have a clear connection to Fedora? + What is the likelihood that this session contributes to something positive for the future of Fedora? +. *Personal Appeal*: + This is your personal point. + Use it however you want! + If there is a session you just _really like_ and you have a hard time explaining why, this point is for you. + Alternatively, if there is something you really don't like, you can also downvote it (although we likely want to know why in the comments). diff --git a/modules/flock/pages/cfp-reviewer-guidelines.adoc b/modules/flock/pages/cfp-reviewer-guidelines.adoc new file mode 100644 index 0000000000000000000000000000000000000000..8f9629b54521f87821981a238e48654511d28d0f --- /dev/null +++ b/modules/flock/pages/cfp-reviewer-guidelines.adoc @@ -0,0 +1,58 @@ += CFP reviewer guidelines +Justin W. Flory + +This page provides guidance to CFP reviewers for the https://flocktofedora.org[Flock to Fedora] conference. +CFP reviewers are invited by core Flock organizers as volunteers to help curate diverse content and programming at our contributor conference. + + +[[voting]] +== Voting + +The CFP system allows a reviewer to cast a vote between -3 and 3, where -3 means definitely not to accept and a 3 is a perfect submission. +We ask each reviewer to give each of their points a significant meaning to help standardize the value of the voting system. + +[[voting-understandable]] +=== Q1: Is the proposal understandable, clear, and written in acceptable English? + +* *Give one point (+1)*: + If abstract is written clearly and the submitter did a good job of describing their topics. + It should be clear what the submitter will talk about and why their topic(s) are relevant to the Fedora contributor community. +* *Give no point (+0)*: + They submit an interesting abstract, but there are missing details or uncertainties about what the submitter will prepare. +* *Take one point (-1)*: + The abstract is poorly written and/or it is unclear what the speaker is proposing. + +[[voting-thematic]] +=== Q2: Does the proposal have a clear connection to a Fedora focus area? + +* *Give one point (+1)*: + The proposal has a clear connection to a thematic focus area of the Fedora 2028 Strategy. + The submitter acknowledges the focus area in their abstract or describes the connection between the focus area and their topic(s) well. +* *Give no point (+0)*: + The proposal acknowledges a thematic focus area, but the submitter does NOT connect the focus area and their topic(s) well. +* *Take one point (-1)*: + The proposal does not acknowledge a thematic focus area or seems irrelevant to the focus area selected by the submitter. + +As a reminder, the Fedora 2028 Strategy focus areas are below: + +* Accessibility (a11y) +* Reaching the World +* Community Sustainability +* Technology Innovation and Leadership +* Editions, Spins, and Interests +* Ecosystem Connections + +[[voting-quality]] +=== Q3: As a CFP reviewer and Fedora contributor, do you believe the proposal advances the quality of Flock and the Fedora community? + +This question requires subjectivity. +However, as a member of the CFP reviewer team, your subjectivity is what we are looking for. +This point is left up to you to decide how to assign it. +You can come up with your own criteria or just follow a gut feeling. + +* *Give one point (+1)*: + You believe that this proposal advances the quality of Flock to Fedora and the Fedora community. +* *Give no point (+0)*: + You are unsure whether this proposal advances the quality of Flock to Fedora and the Fedora community. +* *Take one point (-1)*: + You believe this proposal reduces the quality of Flock to Fedora and the Fedora community.