From 7a127a47f71a8b6999911d90e69768e02726e83e Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jun 24 2020 11:46:26 +0000 Subject: [PATCH 1/3] switching to Discourse --- diff --git a/modules/ROOT/pages/editorial-meetings.adoc b/modules/ROOT/pages/editorial-meetings.adoc index aa0a928..0645dc9 100644 --- a/modules/ROOT/pages/editorial-meetings.adoc +++ b/modules/ROOT/pages/editorial-meetings.adoc @@ -115,7 +115,7 @@ When the schedule is set and agreed upon, announce it by: #topic 6/ Article proposals to clarify / approve #info Review the the article proposals and decide about what's next — a new article spec? more discussion? - #link Article proposals: https://pagure.io/fedora-magazine-proposals/issues + #link Article proposals in our forum: https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine The final step is to review and approve proposals. This is important for our contibutors so they can start writing their articles. @@ -140,7 +140,7 @@ Before the end of the meeting, we need to select next week's xref:editor-of-the- === After the meeting -Send the minutes to the list. That includes the three links zodbot prints out after the meeting is ended. +Send the minutes to the forum. That includes the three links zodbot prints out after the meeting is ended. Subject: Editorial board meeting recap YYYY-Mmm-DD diff --git a/modules/ROOT/pages/getting-access.adoc b/modules/ROOT/pages/getting-access.adoc index a47e89f..6274312 100644 --- a/modules/ROOT/pages/getting-access.adoc +++ b/modules/ROOT/pages/getting-access.adoc @@ -7,7 +7,7 @@ include::partial$workflow-change-banner.adoc[] **2. Sign in to the Fedora Magazine**: Now, using your FAS Account, https://fedoramagazine.org/wp-admin/[sign in to the Fedora Magazine here]. -**3. Sign in to the Taiga board**: Again, using your FAS Account, https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[sign in to the Taiga Board] using the __OpenID Connect__ button. +**3. Sign in to the Taiga board**: Again, using your FAS Account, https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[sign in to the Taiga Board]. -**3. Join the Magazine list and introduce yourself**: Next up, subscribe to the https://lists.fedoraproject.org/admin/lists/magazine@lists.fedoraproject.org[Fedora Magazine mailing list]. This is where we discuss everything to do with the Fedora Magazine. Introduce yourself and tell us that you wish to contribute to the Fedora Magazine. A Fedora Magazine editor will then grant you access to create and edit posts, and submit them for review. +**3. Join the Magazine forum and introduce yourself**: And finally, join the discussion in the https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum]. This is where we discuss everything to do with the Fedora Magazine. Introduce yourself and tell us that you wish to contribute to the Fedora Magazine. A Fedora Magazine editor will then grant you access to create and edit posts, and submit them for review. diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index 556038f..2c416ea 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -22,7 +22,7 @@ We really need your help on the Magazine. Consider xref:contributing.adoc[writin We also have regular xref:editorial-meetings.adoc[editorial board meetings]. * IRC Channel: https://webchat.freenode.net/?channels=#fedora-magazine[#fedora-magazine] -* Mailing list: https://lists.fedoraproject.org/admin/lists/magazine@lists.fedoraproject.org/[magazine] +* Forum: https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum] diff --git a/modules/ROOT/pages/workflow-article-proposal.adoc b/modules/ROOT/pages/workflow-article-proposal.adoc index d8af30e..1d73de9 100644 --- a/modules/ROOT/pages/workflow-article-proposal.adoc +++ b/modules/ROOT/pages/workflow-article-proposal.adoc @@ -6,13 +6,11 @@ image::fedora-magazine-workflow-1.jpg[,100%,] Anyone is welcome to propose an article! -The proposal can be either just an idea, or a specific pitch (an example is below). Proposing an article doesn't automatically mean the same person needs to write it. Having a good set of ideas helps writers to just write what they know is relevant for the Magazine, without necessarily thinking about new content just so they can write something. +Proposals can be ideas or specific pitches (an example is below). Proposing an article doesn't automatically mean the same person needs to write it. Having a good set of ideas helps writers to just write what they know is relevant for the Magazine, without necessarily thinking about new content just so they can write something. == Submitting an idea -If you have a https://admin.fedoraproject.org/accounts/[Fedora account], the preferred way is to https://pagure.io/fedora-magazine-proposals/issues[open an issue in the Fedora Magazine Proposals issue tracker]. - -Alternatively, if you don't have a https://admin.fedoraproject.org/accounts/[Fedora account], you can email your proposal to the https://lists.fedoraproject.org/admin/lists/magazine.lists.fedoraproject.org/[Fedora Magazine list]. +Join the community in the https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum] and submit your idea as a new topic. TIP: If this is your first proposal, and you also plan to write an article, you can help us speed the process up by logging into our https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[Taiga board] — click on the "OpenID Connect" button on the login form to log in with your Fedora Account. That is required before you can be added to the board as a writer. diff --git a/modules/ROOT/pages/workflow-clarification.adoc b/modules/ROOT/pages/workflow-clarification.adoc index 4fa5353..7d1f463 100644 --- a/modules/ROOT/pages/workflow-clarification.adoc +++ b/modules/ROOT/pages/workflow-clarification.adoc @@ -8,19 +8,17 @@ The Editorial Board reviews each proposal and creates a specific article descrip Proposals might be discussed with the person who proposed them, with subject matter experts, and anyone who wants (or has the technical ability to) give an input. We encourage anyone in the community to provide feedback to the proposals! -== Where to discuss +== Discussing and approving proposals -The discussion happens in the respective issue or email thread. - -Issues are submitted in the https://pagure.io/fedora-magazine-proposals/issues[Fedora Magazine Proposals issue tracker], and emails are sent to the https://lists.fedoraproject.org/admin/lists/magazine.lists.fedoraproject.org/[Fedora Magazine mailing list]. +Proposals are submitted to the https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum] as topics, and discussion happens right there. Opinions and additional relevant information is welcome from anyone. -== Writing an article spec +If an editor is happy with the proposal, all they need to do is to reply "+1". Proposals with two or more +1's are approved. -When the review is complete, a new card is created in the https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[Kanban board in Fedora Magazine Taiga], in the __Article Spec__ column. +When a proposal is approved, a new card is created in the https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[Kanban board in Fedora Magazine Taiga], in the __Article Spec__ column. -This card now represent a specific articles and goes through all the other steps of the workflow. +This card now represents a specific article and goes through all the other steps of the workflow. == Workflow **Previous step:** xref:workflow-article-proposal.adoc[Article Proposal] diff --git a/modules/ROOT/pages/workflow.adoc b/modules/ROOT/pages/workflow.adoc index 5fec756..023f034 100644 --- a/modules/ROOT/pages/workflow.adoc +++ b/modules/ROOT/pages/workflow.adoc @@ -17,6 +17,6 @@ An initial proposal lands in the __idea__ state. After some clarification, a spe == Tracking -Proposals in the **__idea__** state are represented issues in our https://pagure.io/fedora-magazine-proposals/issues[Fedora Magazine Proposals issue tracker]. Everyone is welcome to submit one! +Proposals in the **__idea__** state are among the general discussion in the https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum]. Everyone is welcome to submit one! Articles in **all other states** are represented as cards in the https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[Kanban section of the Fedora Magazine Taiga], each state having its own column on the board. Join our team either as a xref:contributing.adoc[writer] or as an xref:editorial.adoc[editor], and help us make wonderful content read by tens of thousands of readers every week! \ No newline at end of file From 6f69f2cdf2f416849598a32cc35ac9f91f871a18 Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jun 24 2020 11:53:26 +0000 Subject: [PATCH 2/3] add a discourse banner --- diff --git a/modules/ROOT/pages/adding-a-writer.adoc b/modules/ROOT/pages/adding-a-writer.adoc index a8e6859..829460b 100644 --- a/modules/ROOT/pages/adding-a-writer.adoc +++ b/modules/ROOT/pages/adding-a-writer.adoc @@ -1,5 +1,7 @@ = Adding a Writer +include::partial$workflow-change-banner.adoc[] + When a new writer joins the Magazine, they usually want to track their work in our kanban. Whether they take an existing article or suggest their own, an editor needs to add them to the kanban's list of permissions. . Ask the writer to login to link:https://teams.fedoraproject.org/project/asamalik-fedora-magazine/kanban[the kanban instance] if they have not done so already. diff --git a/modules/ROOT/pages/editor-of-the-week.adoc b/modules/ROOT/pages/editor-of-the-week.adoc index 15456d3..d923b41 100644 --- a/modules/ROOT/pages/editor-of-the-week.adoc +++ b/modules/ROOT/pages/editor-of-the-week.adoc @@ -1,5 +1,7 @@ = Fedora Magazine Editor of the Week +include::partial$workflow-change-banner.adoc[] + In order to promote accountability and spread the workload, we have the Editor of the Week role for Fedora Magazine. == Selection diff --git a/modules/ROOT/pages/editorial-meetings.adoc b/modules/ROOT/pages/editorial-meetings.adoc index 0645dc9..9b40a10 100644 --- a/modules/ROOT/pages/editorial-meetings.adoc +++ b/modules/ROOT/pages/editorial-meetings.adoc @@ -1,5 +1,7 @@ = Fedora Magazine editorial meetings +include::partial$workflow-change-banner.adoc[] + The goal of this meeting is to set and execute a publishing schedule of appropriate material for the Fedora Magazine. :hash: # diff --git a/modules/ROOT/partials/workflow-change-banner.adoc b/modules/ROOT/partials/workflow-change-banner.adoc index e69de29..c58f501 100644 --- a/modules/ROOT/partials/workflow-change-banner.adoc +++ b/modules/ROOT/partials/workflow-change-banner.adoc @@ -0,0 +1 @@ +NOTE: Starting 25 June 2020, Magazine-related **discussions have moved** to a new place: the https://discussion.fedoraproject.org/c/project/Discussion-related-to-Fedora-Magazine[Fedora Magazine Discourse forum]. New article proposals are also being submitted there. \ No newline at end of file From 4a824014e629a0da0562aebc38010d1f507effdc Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jun 25 2020 09:12:11 +0000 Subject: [PATCH 3/3] reword a sentence in article proposals --- diff --git a/modules/ROOT/pages/workflow-article-proposal.adoc b/modules/ROOT/pages/workflow-article-proposal.adoc index 1d73de9..3203286 100644 --- a/modules/ROOT/pages/workflow-article-proposal.adoc +++ b/modules/ROOT/pages/workflow-article-proposal.adoc @@ -6,7 +6,7 @@ image::fedora-magazine-workflow-1.jpg[,100%,] Anyone is welcome to propose an article! -Proposals can be ideas or specific pitches (an example is below). Proposing an article doesn't automatically mean the same person needs to write it. Having a good set of ideas helps writers to just write what they know is relevant for the Magazine, without necessarily thinking about new content just so they can write something. +Proposals can be ideas or specific pitches (an example is below). Proposing an article doesn't automatically mean the same person needs to write it. Having a good set of ideas helps writers to write what they know is relevant for the Magazine. == Submitting an idea