Page MenuHomePhabricator

Define and document Editorial guidelines for authors in Tech blog
Closed, ResolvedPublic

Description

The Wikimedia tech blog should have a clear set of editorial and publication guidelines so individuals who wish to publish their posts will know how to proceed.

Requirements

  • Determine and provide clear points of contact for the blog --Who will be administering the blog and reviewing posts? Who will take responsibility for answering questions individuals have about publication in the blog?
  • Create clear content guidelines (What kinds of posts should be in the blog? What kinds of posts should go elsewhere (Ex Phame, or the Foundation blog (if available), or third party/personal blogs.
  • Outline workflows for submission and publication to the tech blog (including publication cadence).
  • Determine Style guidelines to use.

Other workflows to consider

Event Timeline

Aklapper triaged this task as Medium priority.Jan 22 2020, 1:46 PM

https://meta.wikimedia.org/wiki/Wikimedia_Blog/Guidelines -- Should be updated in tandem with the tech blog guidelines. I noticed some areas of double coverage here and want to make sure folks are not confused about which venue is appropropriate for them to publish in.

srodlund updated the task description. (Show Details)
srodlund updated the task description. (Show Details)

From a very quick read: Maybe add links to those "Twitter" and "Facebook" things? How can I receive an email about my post having been published if you might not know my email address? How to find out what a "freely licensed image" is? Should "get in touch with us" be a link? "Open Source" should be "Free and open source". Does "on MediaWiki" mean "on MediaWiki.org" or "in the MediaWiki software"?

  • Links to Twitter added
  • Potential posts will be managed through Phabricator
  • Resolved image question on another ticket
  • Posted guidelines on MediaWiki.org

Editorial guidelines are now documented here: https://www.mediawiki.org/wiki/Wikimedia_technical_blog_editorial_guidelines

Resolving for now -- though the guidelines will be considered in draft until launch.

@srodlund: From a quick reading:

Hi @Aklapper -- if you read the full editorial guidelines, you will see people need to file a Phabricator task. It is prefilled with questions for people to answer to get the process started.

The reason it is unclear where the draft will go is that it will depend on the individual post and that is something the blog admins will work out with the individual when they discuss the post. Part of making the blog accessible is being able to work with writers individually and understand the tools they are using rather than making a sweeping decision that drafts must all be in one format.

You are also welcome to make changes to the draft if you see errors that you think should be corrected.

Hi @Aklapper -- if you read the full editorial guidelines, you will see people need to file a Phabricator task. It is prefilled with questions for people to answer to get the process started.

Yes, I saw that... I'm told so under "Publishing", a while after I was already told to contact you under "Prewriting".

The reason it is unclear where the draft will go is that it will depend on the individual post and that is something the blog admins will work out with the individual when they discuss the post. Part of making the blog accessible is being able to work with writers individually and understand the tools they are using rather than making a sweeping decision that drafts must all be in one format.

I wasn't after one single format, I'd prefer to know which formats would be acceptable before I'm about to start prewriting. As an author, I'd like to avoid spending time later needed to convert my draft from LaTeX to another file format (in case that LaTeX is not acceptable, which I currently cannot tell from the docs). If literally any format is acceptable it would be great to explicitly say so. :)

Fair enough. I can change that :-)