This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 20154 - [meta][6 Hour] - Improve Editors Guide
Summary: [meta][6 Hour] - Improve Editors Guide
Status: RESOLVED FIXED
Alias: None
Product: webplatform.org
Classification: Unclassified
Component: content (show other bugs)
Version: unspecified
Hardware: All All
: P2 critical
Target Milestone: ---
Assignee: Jonathan Garbee
QA Contact: public-webplatform-bugs list
URL:
Whiteboard:
Keywords:
Depends on: 20160
Blocks:
  Show dependency treegraph
 
Reported: 2012-11-29 12:31 UTC by Jonathan Garbee
Modified: 2013-02-20 23:06 UTC (History)
1 user (show)

See Also:


Attachments

Description Jonathan Garbee 2012-11-29 12:31:25 UTC
URL: http://docs.webplatform.org/wiki/WPD:Editors_Guide

We need to centralize all the information an editor needs to make good edits on the site into one area.  Right now we have many pages spread about which have details on this and there is no true structure to them.

Basically the Editor's Guide will be the central repository of all information for editing.  If it is not in here, then you ask and we improve the guide accordingly.

Target initial completion: 12-8-12
Comment 1 Jonathan Garbee 2012-11-30 11:30:49 UTC
Rough outline is up on GitHub [1].  Any thoughts?

[1] https://github.com/Garbee/webplatform/blob/master/content/Editors%20Guide/outline.rtf
Comment 2 JuleeAtAdobe 2012-12-04 04:27:21 UTC
Just want to give you a sense of how the getting started experience is currently for editors:

https://github.com/JuleeAtAdobe/wpd/blob/master/getting-started-for-editors/getting-started-for-editors.rtf

I think the biggest barriers to contributing (excluding session difficulties) are:

1. Too many pages instructing how to get started and edit.
2. Too many steps to successfully contribute.

So how about this? Add a section in between to your outline on github, that basically sets up a dashboard for the editor:

Set up your environment:

* Here's your critical style guides and reference pages.
* Here's your community: irc, maillist, forums.
* Here's your tasks: tasklists, bugbase, whatever.
Comment 3 Jonathan Garbee 2013-02-20 23:06:16 UTC
The Editor's Guide is much improved now. Any further issues should be their own report (in the new tracker.)