#48 Updated some discussion.fedoraproject.org links
Merged 4 months ago by jakfrost. Opened 4 months ago by glb.
glb/fedora-magazine update-discourse-links  into  master

@@ -19,7 +19,7 @@ 

  in the card's comment section. Only the editors can update the card's status/column.

  

  **4. Join the Magazine forum and introduce yourself**:

- Join the discussion in the https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum].

+ Join the discussion on the https://discussion.fedoraproject.org/tag/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.

  The Fedora Magazine editors monitor this Discourse forum and will be able to help you and answer any Fedora

file modified
+17 -6
@@ -17,14 +17,25 @@ 

  

  == Join the Magazine Team

  

- We really need your help on the Magazine. Consider xref:contributing.adoc[writing an article]. You'll also find a link for how to join the marketing mailing list at that link. There is also a detailed guide on how to make a post on the magazine.

+ We really need your help on the Magazine. Consider xref:contributing.adoc[writing an article].

+ There is also a detailed guide on how to make a post on the magazine.

  

- We also have regular xref:editorial-meetings.adoc[editorial board meetings].

+ We also have regular xref:editorial-meetings.adoc[editorial board meetings] on chat.fedoraproject.org.

+ See the https://discussion.fedoraproject.org/t/meeting-and-publication-schedule/34554[Meeting and Publication Schedule]

+ for exactly when and where.

  

  :hash: #

  

- * Forum: https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum]

- * Matrix Channel: https://matrix.to/#/#magazine:fedoraproject.org?web-instance%5Belement.io%5D=chat.fedoraproject.org[{hash}magazine:fedoraproject.org]

- 

- 

+ We also have two areas on the discussion.fedoraproject.org forum for Fedora Magazine topics.

+ One section (under the _Team Workflows_ category) is reserved just for article proposals.

+ When you start a new topic there, the post should be pre-populated with a simple outline that you can complete to make a new proposal.

+ The other area is for anything else related to Fedora Magazine.

+ These can be posts about the site theme, the tools and platforms being used in the workflow,

+ when weekly meetings will be held (or skipped), or anything else.

+ All non-article-proposal posts concerning Fedora Magazine should be tagged with the special _{hash}magazine_ tag.

+ 

+ * Chat Room: https://matrix.to/#/#magazine:fedoraproject.org?web-instance%5Belement.io%5D=chat.fedoraproject.org[{hash}magazine:fedoraproject.org] (powered by https://matrix.org[Matrix])

+ * Forum: https://discussion.fedoraproject.org/

+ ** Click https://discussion.fedoraproject.org/new-topic?category=workflows/magazine[here] to start a new article proposal.

+ ** Click https://discussion.fedoraproject.org/new-topic?category=project&tags=magazine[here] to start a new conversation about anything else related to Fedora Magazine.

  

@@ -10,17 +10,28 @@ 

  

  == Submitting an idea

  

- Join the community in the https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum] and submit your idea as a new topic.

+ Join the community on the https://discussion.fedoraproject.org/new-topic?category=workflows/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://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure] — Select the __Log In__ button to log in with your Fedora Account. That is required before an article can be assigned to you.

+ 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://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure]

+ — Select the __Log In__ button to log in with your Fedora Account.

+ That is required before an article can be assigned to you.

  

  == A specific pitch example

  

- __The following article serves as an example outline for proposing a new pitch for the Fedora Magazine. This example was used for the https://fedoramagazine.org/never-leave-irc-znc/[Never leave IRC again with ZNC] article.__

+ __The following article serves as an example outline for proposing a new pitch for the Fedora Magazine.

+ This example was used for the https://fedoramagazine.org/never-leave-irc-znc/[Never leave IRC again with ZNC] article.__

  

  **Summary**: Describe how to set up an IRC bouncer using ZNC

  

- **Description**: The purpose of this article would be to describe what an IRC bouncer is and how someone can set up their own ZNC instance to connect to IRC networks and remain persistently connected to channels. The article would aim to educate the user about two things: what and how. Since IRC is a major communication platform for Fedora (and most free and open-source project communities), this article would ideally promote using IRC as well. The flow of the article would be as follows:

+ **Description**: The purpose of this article would be to describe what an IRC bouncer is

+ and how someone can set up their own ZNC instance to connect to IRC networks and remain persistently connected to channels.

+ The article would aim to educate the user about two things: what and how.

+ Since IRC is a major communication platform for Fedora (and most free and open-source project communities),

+ this article would ideally promote using IRC as well.

+ The flow of the article would be as follows:

  

  * What is an IRC bouncer / proxy and how does it work?

  * Introducing ZNC

@@ -6,19 +6,27 @@ 

  

  The Editorial Board reviews each proposal and creates a specific article description.

  

- 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!

+ 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!

  

  == Discussing and approving proposals

  

- Proposals are submitted to the https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum] as topics, and discussion happens right there.

+ Proposals are submitted to the https://discussion.fedoraproject.org/c/workflows/magazine/57[Fedora Magazine Discourse forum]

+ as topics, and discussion happens right there.

  

  Opinions and additional relevant information is welcome from anyone.

  

- 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.

+ 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 a proposal is approved, a new card is created by an editor in the https://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure], in the __ideas__ column.

+ When a proposal is approved, a new card is created by an editor

+ in the https://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure]

+ in the __ideas__ column.

  

- When the card is created, and the author is known, the owner is assigned in the __Assignee__ field, under the METADATA column.  This ensures the author is emailed when the card status changes. This operation is performed by the editor.

+ When the card is created, and the author is known, the owner is assigned in the __Assignee__ field under the METADATA column.

+ This ensures the author is emailed when the card status changes.

+ This operation is performed by the editor.

  

  This card now represents a specific article and goes through all the other steps of the workflow.

  

@@ -12,12 +12,20 @@ 

  4. xref:workflow-review.adoc[Review] by Editors

  5. xref:workflow-edit-image.adoc[Edit & Image] by Editors

  

- An initial proposal lands in the __idea__ state. After some clarification, a specific article goes through five states. Starting as an __idea__, it progresses to __in progress__, __review__, __to edit__, and finally ending up being __scheduled__. Each step in the workflow has its own page in this documentation that provides guidance.

+ An initial proposal lands in the __idea__ state.

+ After some clarification, a specific article goes through five states.

+ Starting as an __idea__, it progresses to __in progress__, __review__, __to edit__, and finally ending up being __scheduled__.

+ Each step in the workflow has its own page in this documentation that provides guidance.

  

  == Tracking

  

- Proposals in the _idea_ state are among the general discussion in the https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum]. Everyone is welcome to submit one!

+ Article proposals in are initiated and discussed under the _Team Workflows_ section

+ of the https://discussion.fedoraproject.org/c/workflows/magazine/57[Fedora Magazine Discourse forum].

+ Everyone is welcome to submit one!

  

- Articles in all other states are represented as cards in the https://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure]. Each state has its own column on the board with the appropriate title.

+ Articles in all other states are represented as cards

+ in the https://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban section of the Fedora Magazine Pagure].

+ Each state has its own column on the board with the appropriate title.

  

- 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!

+ 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!

@@ -4,6 +4,6 @@ 

  

  Fedora Magazine welcomes anyone to submit ideas for articles.

  

- Just propose your idea in our https://discussion.fedoraproject.org/c/project/magazine/[Fedora Magazine Discourse forum]

+ Just propose your idea on our https://discussion.fedoraproject.org/new-topic?category=workflows/magazine[Fedora Magazine Discourse forum].

  

  See the xref:workflow-article-proposal.adoc[Editorial Workflow - Article Proposal] page for more information.

@@ -6,8 +6,12 @@ 

  

  Anyone with good writing skills is welcome to write an article for the Fedora Magazine!

  

- __Writing an article requires write access to our 

- https://pagure.io/fedora-magazine-newsroom/boards/articles[Fedora Magazine Pagure] (so you can indicate progress and exchange information with the editors) and to our https://fedoramagazine.org/admin[Wordpress instance] (where the articles are written). Read the xref:getting-access.adoc[Getting Access] page for more information.__

+ __Writing an article requires write access

+ to our https://pagure.io/fedora-magazine-newsroom/boards/articles[Fedora Magazine Pagure]

+ (so you can indicate progress and exchange information with the editors)

+ and to our https://fedoramagazine.org/admin[Wordpress instance]

+ (where the articles are written).

+ Read the xref:getting-access.adoc[Getting Access] page for more information.__

  

  == Writing an article

  
@@ -17,27 +21,44 @@ 

  https://pagure.io/fedora-magazine-newsroom/boards/articles[Kanban board of the Fedora Magazine Pagure]. 

  Or, https://docs.fedoraproject.org/en-US/fedora-magazine/workflow-article-proposal/[propose your own].

  

- **Assign** Open a topic, if necessary in the the https://discussion.fedoraproject.org/c/project/magazine[Fedora Magazine Discourse forum], and let the editors know you would like to be the author of an article. 

- Make certain you tell them the number. If you have been in contact with the editors regarding an article, simply let them know in your ongoing conversation.

+ **Assign** Open a topic,

+ if necessary in the the https://discussion.fedoraproject.org/new-topic?category=workflows/magazine[Fedora Magazine Discourse forum],

+ and let the editors know you would like to be the author of an article.

+ Make certain you tell them the number.

+ If you have been in contact with the editors regarding an article, simply let them know in your ongoing conversation.

  

  The editors will assign the article to you and move it to _in-progress_ in the 

  https://pagure.io/fedora-magazine-newsroom/boards/articles[Fedora Magazine Kanban board].

  

  === 2. Write it 

  

- **Write** your article https://fedoramagazine.org/admin[in the Magazine Wordpress] (create a new article there). Read the xref:writing-guidelines.adoc[Writing Guidelines] page for specific guidance about our preferred writing style.

+ **Write** your article https://fedoramagazine.org/admin[in the Magazine Wordpress]

+ (create a new article there).

+ Read the xref:writing-guidelines.adoc[Writing Guidelines] page for specific guidance about our preferred writing style.

  

- https://fedoramagazine.org/how-to-structure-your-article/[Here’s a template you can use] to structure your article well, and make it as useful as possible to readers. Make sure you set the article status from __Pitch__ to __Draft__ once you receive approval.

+ https://fedoramagazine.org/how-to-structure-your-article/[Here’s a template you can use] to structure your article well,

+ and make it as useful as possible to readers.

+ Make sure you set the article status from __Pitch__ to __Draft__ once you receive approval.

  

- As you write your draft, try to understand and follow the xref:writing-guidelines.adoc[style, grammar, and SEO guidelines] for the Magazine. Don’t skip this step! The guidelines tell you how to use markup, write better sentences, and get your article ranked well in search engines. Also, if you write a better article, the editors are more likely to publish it sooner.

+ As you write your draft, try to understand and follow

+ the xref:writing-guidelines.adoc[style, grammar, and SEO guidelines] for the Magazine.

+ Don’t skip this step!

+ The guidelines tell you how to use markup, write better sentences, and get your article ranked well in search engines.

+ Also, if you write a better article, the editors are more likely to publish it sooner.

  

  === 3. Mark it as done

  

- When you feel you are done writing the article and it is ready for review, state that in a comment on your card in Pagure. The editors will move it to _review_ in the Kanban board. Please make certain you include a link to the WordPress preview for your article in the comments on the card so the Editors can access it.

+ When you feel you are done writing the article and it is ready for review,

+ state that in a comment on your card in Pagure.

+ The editors will move it to _review_ in the Kanban board.

+ Please make certain you include a link to the WordPress preview for your article in the comments on the card so the Editors can access it.

  

  And that's it!

  

- Please note that in some cases the editors might require a change in your article. In that case, you'll receive feedback in the card, and it will be moved back to the _in-progress_ column. Please make the requested change and let the editors know in the comments. They will move it back to _review_.

+ Please note that in some cases the editors might require a change in your article.

+ In that case, you'll receive feedback in the card, and it will be moved back to the _in-progress_ column.

+ Please make the requested change and let the editors know in the comments.

+ They will move it back to _review_.

  

  == Workflow

  **Previous step:** xref:workflow-clarification.adoc[Clarification]