Editor's Guide [DONE]
This is a proposed outline for consolidating dozens of pages under a guide to editing WPD. This will be a procedural guide, beginning with getting up and running on the site and communications channels, to reviewing content, to creating new content. All content currently available for assisting editors will be pulled into this guide, either by merging that content into this guide, or by reference. Comments welcome on this page or on the firstname.lastname@example.org email list.
Step 1: Register for a WebPlatform.org wiki account
Create an account with your email address, user name, and password.
Make sure to verify your account.
- The verification link is sent via email. If you don't see the message, check your spam folder.
Log into the WebPlatform.org site.
Join IRC channel.
- The WebPlatform.org online community uses IRC extensively. Log in and ask questions.
- Or download and install an IRC client that enables you to chat in the #webplatform channel. Here are some reliable IRC clients you can use:
- Log in anytime you want to share ideas or ask questions
- [COMMENT:] No change to the Meetings pages.
- Log in during meetings. Here are the meeting calendars and the archives of meeting notes:
Join the email@example.com.
- We announce initiatives and work out proposals on the W3.org mailing list. Subscribe to the w3.org mailing list.
Ask questions or help others in the forum.
- [COMMENT:] REALLY wish this was called "Forums" not Q&A - which sounds like an FAQ list to me. Is it possible to set up a forum channel for contributors to ask questions about editing or authoring content to the wiki? (Rather than just general web questions).
Access the bug-tracking system.
Step 3: Become familiar with the wiki
If you can't wait, start contributing.
- Make sure to use the reference resources in Step 5, below, to ensure you're using the correct markup and styles.
- [COMMENT:] The Getting Started page is the primary resource that contributors can use to edit the site. Make sure the Getting Started page links to the wiki syntax page. Make sure contributors understand Step 4, how to add comments and flag pages.
Be sure to read the wiki philosophy to understand the mission.
- Watch the project video to learn about the site's mission and goals.
- Read the FAQ and site policies and look at the direction we're going in.
Explore the web development docs.
Step 4. Review existing content
- Add a comment by hovering your mouse over the relevant section heading and click Add Comment. Leaving comments on articles helps others see exactly what needs to be fixed.
- [COMMENT:] Provide a screenshot?
Flag issues: broken links, spelling, product bias, and more.
- Click the Edit button in the top right corner of the article and choose Edit.
Mark articles that need revisions by checking the corresponding checkboxes.
Notify other editors about pages that require revisions.
- Communicate with the WebPlatform.org online community to ask for clarification and help resolving issues. You can raise issues on IRC, send messages to the firstname.lastname@example.org mail list, or post to forums.
- [COMMENT:] This is a duplicate of Step 3, but I think it is OK to reiterate this.
Step 5. Update existing content
Become familiar with MediaWiki syntax conventions.
Read the guidelines and best practices for editing the text.
Conform content to one style when editing.
- WebPlatform.org uses the Yahoo Style Guide:
Find content that needs your review.
- Review recently edited articles.
- Visit the Most Wanted Tasks page to find articles to fix.
Step 6. Author or upload new content
Refer to the Style_Guide to determine if your content is appropriate for the wiki.
Let the team know that you are adding new content.
Before creating or moving pages, identify pages linked to existing docs.
Select where to create the new page.
Check features for cross browser compatibility.
- Here are some good cross-compatibility resources:
Visit the New Page center, choose a type (Tutorial) and click Create.
Step 7. Prepare and upload assets for articles
- Optimize PNG image files and resize to a maximum width of 650px. Some popular optimizers are:
Name image file names descriptively.
- Right: chrome_prefs.png, drop_shadow.png, box_model_diagram.png
- Wrong: image 04.png, screenshot.png, figure10.png, code.png
Use the Upload File page to upload the images.
Add the link to an uploaded image in the article draft.
- Enter the syntax to link the uploaded image file in the article: [[File:File.jpg]]