Important note: This Wiki page is edited by participants of the EOWG. It does not necessarily represent consensus and it may have incorrect information or information that is not supported by other Working Group participants, WAI, or W3C. It may also have some very useful information.


EOWG Participation Info

From Education & Outreach
Jump to: navigation, search

Welcome to the W3C Web Accessibility Initiative (WAI) Education and Outreach Working Group (EOWG)!

The Basics

The EOWG home page is: http://www.w3.org/WAI/EO/

The main wiki page is: https://www.w3.org/WAI/EO/wiki/Main_Page

Work and agendas

E-mail Lists

The following e-mails lists are currently used by EOWG. All are publicly archived.

  • w3c-wai-eo@w3.org — main EOWG list - goes to all participants (and about 100 lurkers)
  • public-eo-plan@w3.org — for planning work in EOWG. goes to Co-Chairs and Staff (and anyone else crazy enough to subscribe). EOWG participants use this list when you want to bring work to the EO planning team and to all of EOWG.
  • public-eo-archive@w3.org — place to archive stuff without cluttering other lists. Editorial Teams folks should CC this list when they are communicating with their teams directly. (If you use a Resource-Team-specific list below, then just send to that list; don't need to also send to this list :-).
  • wai-eo-editors@w3.org — purpose: for public and others to get messages to the WG on things that need edits -- for those who won't want to do it through GitHub. goes to chairs and staff (and anyone else crazy enough to subscribe)

Task Force and Resource Team lists:

  • public-wai-eo-site@w3.org — WAI Site Redesign Task Force
  • public-eo-develop-training@w3.org — for Resource Teams on Developing Web Accessibility Presentations and Training

Note: Resources editors and project leads can choose to have a separate list for their Editorial Teams — just ask Shawn.

Telecons

Friday weekly: Our usual teleconference meeting time is 8:30am - 10:30am Eastern time (EDT/EST) on Fridays. To find what time this is in your region, you can check the world clock meeting planner. The phone connection and IRC info is linked from the EOWG meetings wiki page.

Periodic: We periodically have teleconferences that are more convenient in the Asia-Pacific and North American west coast (Pacific) time zones. Those are usually:

  • UTC: Thursday at 1:30am
  • AWST: Thursday at 9:30am
  • NA Pacific Time: Wednesday at 5:30pm

Availability for telecons

Please indicate your Availability for Upcoming EOWG Teleconferences in the form at:
http://www.w3.org/2002/09/wbs/35532/availability/
You can change your answers at any time. The link to this form is on the EOWG home page near the top under "EOWG questionnaires (WBS):" and also on the EOWG Meetings wiki page under "Work for this week", Every week.

IRC

We use IRC during the teleconference to take minutes, share links, indicate support or not for proposals, etc. You can join IRC through a web browser or IRC client:

  • Information on using W3C IRC from a browser is here: IRC
  • Most people download an IRC client
    To join the EOWG IRC:
    • Server Address: irc.w3.org
    • Port: 6667, 6665, 21 (choose one)
    • Channel: #eo

IRC non-minute comments:

  • By default, what you type in IRC shows up in the minutes.
  • To type something that you do not want recorded in the minutes, preface it with:
    /me
    For example:
    /me apologizes for the construction noise in the background
    It will show up in IRC with an asterisk and will not be in the minutes:
    * shawn apologizes for the construction noise in the background

Lots more info: Zakim IRC Bot

Tips

  • Surveys — You can edit surveys the whole time they are open. So you can complete some questions now and others later, change your answers later, etc.
  • GitHub - GitHub training, GitHub W3C info
  • Scribing tips
  • To create a new wiki page:
    • Start from the Main Page
    • Login if you're not (you'll get "[edit]" next to headings if your're logged in)
    • Figure out which heading you want your new page to be under, and click "[edit]" after it
    • Type the new page title in double brackets, e.g.:
[[XYZ Resource Revision 2018]]
    • Save page.
    • Your new page link will appear with (create new page), e.g.:
XYZ Resource Revision 2018

Editorial Teams

EOWG is trying an approach where a specific resource will be worked on first in smaller Editing Teams. We hope this will let individuals focus more attention on specific resources that they are particularly interested in, and help get more resources developed and revised more efficiently.

The expectation is that minor issues can be worked out in the Teams, allowing all of EOWG to focus on bigger issues. Resources brought to all of EOWG will already have been worked through by the Teams and will have clearly defined issues to address.

As a reminder, it is important that for formal EOWG deliverables we:

  • ensure that they reflect the perspectives and contributions of multiple different stakeholders in a wide range of environments (large industry, small consulting, developers, trainers, proj management, policy, geographic, disabilities, etc., etc., etc.)
  • develop consensus among WG participants particularly, and also commenters
  • maintain high quality

Notes:

  • If you want to change your resource team assignments, e-mail public-eo-plan@w3.org
  • Editorial Team participants - commit to reviewing carefully and commenting "in a timely manner".
  • Editorial Team [monitors] - would like to be included in review opportunities, yet don't commit to completing all reviews.

Teams Approach

The overarching approach is that the Teams will:

  • Try to represent a wide range of perspectives (not just their own), and actively solicit input outside of their areas, such as international perspectives.
  • Make initial decisions when there is clear consensus within the Editorial Teams. Communicate the issues where they had some questions or specifically want additional perspectives.
  • For issues where there is not clear agreement within the Teams, the Editors should present the issue for broader input from EOWG (and WAI IG and others as appropriate) — with a brief summary and pointer to background discussions (in GitHub, etc.).

Process for revising existing resources:

  1. Editors review resource and provide summary of significant suggested changes – can be quick bullets – and any questions or issues at this point, especially that impact overall approach.
  2. Discuss with EO Planning Team and see if need EOWG to review suggested changes and big issues.
    (Brent provided example of helpful initial feedback in 21 July teleconference)
  3. Editors draft changes.
    Editorial Team reviews draft.
    As needed, bring issues to EOWG (per next section)
    Iterate as needed — number of iterations needed usually depends on extent of revisions, sensitivity of topic, etc.
  4. When Editorial Teams thinks it's ready, Editors bring to EO Planning Team to schedule EOWG full review. Usually this will be a "Thorough Review" (aka last call). Editorial teams provide:
    • Explanation of any issues for input from EOWG
    • List of changes &/or diff version
Minimum for Relaunch, Log for Later

Important: We want to do minimal work to update and clean up resources for the redesigned website soon. We have planned time later to make revisions that take more time to develop, review, and get consensus on. Please do record ideas for later revision, e.g., in GitHub with Labels and Milestones — e.g, https://github.com/w3c/wai-policies-prototype/issues/223 has label "future enhancement" and milestone "Post-Launch Enhancement".

When and how to bring what to EOWG

We encourage Teams to bring questions, issues, and drafts to EO Planning Team and then to all of EOWG whenever it will be useful to get broad input.

  • Issues can be brought to EOWG (after coordination with EO Planning) individually, as a batch, or along with a draft for review.
  • If a Team needs EOWG input on an issue (such as overall requirements, structure, approach, content outline, etc.) before moving forward with the resource — or if EOWG input could substantially change the work, they should bring it to EOWG soon.
  • If several smaller issues are accumulating, it would probably be good to bring them to EOWG to avoid lots and lots for EOWG to process at once.
  • @@ complete draft for review @@

How to bring issues and drafts to EOWG: It is most efficient to have specific issues/questions for EOWG.

Communications

Optionally, you can have a separate mailing list for your Editorial Teams -- just ask Shawn to set it up.

If you don't have a separate list, CC e-mail communications among your Team participants to public-eo-archive@w3.org. That will:

  • Fulfill EOWG's mandate to conduct work in public space
  • Let us go back and look up or reference info if needed
  • Help Chairs and Staff keep on top of things and see if there are ways they can help

You do not need to replicate GitHub issues to any mailing list; GitHub is sufficient public archive.

Editors:

Editing Approach

For most documents:

  • Simplify & Tersify — Make content simple and brief. Cut words. Cut Sentences.
  • Bullets & Graphics — Break up passages into bullets when appropriate. Suggest graphics.
  • Front-loaded Action — Use active voice, and action statements.

For spelling, punctuation, editorial style tips, etc., see WAI Style Guide (which includes language tools and Edit Examples)

Comments and changes

  • Editors should track, manage, and respond to issues in GitHub and comments in surveys.
  • Generally, Editors can close issues, and should invite the commenter to re-open it if they are not satisfied with the resolution.
  • Editors should usually provide a list of substantial changes &/or issues. In later stages, it is usually helpful to provide a diff showing changes.

To provide a diff using rawgit:

  • @@

Review Stages and Levels

Stages: Resources are typically reviewed by EOWG in the following stages of development:

  1. Rough concept draft (or rough wireframe for tool) — Review for overall content and general design. Do not bother with word-smithing or copy-editing or design nit-picks.
  2. In-progress drafts — Usually there will be specific review questions on certain sections or issues.
  3. Complete draft — Review for things like: Are all points covered - is anything missing? Is there anything in there that shouldn't be? Word-smithing suggestions usually welcome. Try to catch all significant issues at this stage. (if you bring up big issues later, it will be annoying :-)
  4. Thorough review! — Review everything at all levels, including copy-editing. This is the pre-publication review, our internal "last call".
    • Any changes after the Thorough Review will be documented so participants can review just those changes and don't have to re-review the whole resource.
  5. Approval to publish — Usually there shouldn't be any more comments at this stage, it's just the formal sign-off.

Sometimes Task Forces or Editor and Review Teams, rather than all of EOWG, do the middle stages.

Levels:

  • High-level - Comment on organization, structure, flow, tone, approach, meeting audience needs, overall content, etc. Do not bother with word-smithing or copy-editing or design nit-picks.
  • Detailed - Hopefully no high-level comments are needed at this point. Now is the time for detailed comments on specific content, including wording.
  • Show-stoppers - The Editor thinks the resource is ready to publish, and/or we are trying to meet a specific publication date. Only important issues should be raised as show-stoppers. Optional comments are welcome, marked as "editor's discretion" or "future enhancement".