Skip to content

Commit

Permalink
Generated by TRAVIS-CI 458beba
Browse files Browse the repository at this point in the history 
chore: Pull gh-pages building to deploy script (pull #445)

Move the logic for doing the manual gh-pages deployment to the built-in
Travis-CI “script” deployment.
This allows all branches to be built and tested, but only the master
branch to be deployed.
  • Loading branch information
michael-n-cooper committed Aug 15, 2018
1 parent 929bc53 commit 4182fa3
Show file tree
Hide file tree
Showing 23 changed files with 926 additions and 2,273 deletions.
1 change: 1 addition & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
.DS_*
node_modules
86 changes: 78 additions & 8 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,22 +1,92 @@
[![Build Status](https://travis-ci.org/w3c/aria-practices.svg?branch=master)](https://travis-ci.org/w3c/aria-practices)

# WAI-ARIA: Authoring Practices Guide

This repository maintains the WAI-ARIA Authoring Practices Guide.
This is developed by the [ARIA Working Group](http://www.w3.org/WAI/ARIA/).
The staff contact is [Michael Cooper](http://www.w3.org/People/cooper/).

* [Latest editor's draft built from master branch](http://w3c.github.io/aria-practices/)
* [Most recent version published on w3.org](https://www.w3.org/TR/wai-aria-practices-1.1/)
* Developed by the [Authoring Practices Task Force](https://www.w3.org/WAI/ARIA/task-forces/practices/) of the [ARIA Working Group](http://www.w3.org/WAI/ARIA/).
* Staff contact: [Michael Cooper](http://www.w3.org/People/cooper/).

Please do not provide commit access to this repository without coordination.

## Contributing to this Repository
## How the work is organized

* Work is planned and prioritized in our [milestones](https://github.com/w3c/aria-practices/milestones?direction=asc&sort=due_date&state=open). Each milestone corresponds to a working draft or release published to w3.org.
* Work is organized by topic in our [projects](https://github.com/w3c/aria-practices/projects). Each project corresponds to a type of design pattern or section of guidance.
* The [scope of work and roadmap](https://github.com/w3c/aria-practices/wiki/Scope) are described in the project wiki.

## Contributing

1. Comment in an existing issue or raise a new issue, expressing your willingness to help and briefly summarizing the nature of your proposed resolution.
2. An editor will confirm there are no conflicting plans and, if needed, provide guidance.
3. Be sure you have ESLint configured as described below.
4. Read our wiki page about [submitting pull requests](https://github.com/w3c/aria-practices/wiki/Submitting-Pull-Requests).
5. Do some fabulous work and submit a pull request.

Note: Please feel free to ask questions either through an issue or on the [Authoring Practices Task Force mailing list](http://lists.w3.org/Archives/Public/public-aria-practices/).

### Code conformance

* All code should validate in the NU HTML Validator.
Exceptions to this rule are warnings and errors related to
future ARIA features we need to implement.
* To keep code in this repository consistent; editors should use a text editor
that supports [EditorConfig](http://editorconfig.org/).
* All HTML should validate in the NU HTML Validator. Exceptions to this rule are warnings and errors related to future ARIA features that are not yet implemented.
* To keep code in this repository consistent:
* Read the [code guide](https://github.com/w3c/aria-practices/wiki/Code-Guide)
* Use a text editor that supports [EditorConfig](http://editorconfig.org/).
* Make sure All code tests clean with ESLint.

### Running ESLint, the pluggable linting utility for JavaScript and JSX

[ESLint](http://eslint.org/) is an automated code style checker. We use it to
ensure common code styling practices in this repository.
Pull requests with ESLint errors will not be merged.

### Setup ESLint so you can run it locally

1. If you do not already have node.js installed, go to the [node installer](https://nodejs.org/en/download/)
1. When you install Node, NPM is included.
1. In a terminal window from the directory that contains the `aria-practices`
repository, run `npm install`.
A successful install will display a tree of installed packages.

### Test and fix your code

1. Open a terminal window to the directory that contains the `aria-practices` repository
1. The repository has a script defined that will test all JavaScript in the examples directory. To run it, execute the command `npm test`.
1. Many errors can be fixed automatically with the command `npm run fix`.
1. After running fix, test again to see what you need to fix manually.

When the linter encounters errors, it will report them in the console.
The error report will contain the file name and line number, and it will
indicate the character or place in the line that raised the style violation. To
fix an error, satisfy the change that the violation indicates.

For example, here is an error for an invalid variable name style. Variables must
follow a camelCase convention.

```
/Users/user1/Documents/github/aria-practices/examples/slider/js/text-slider.js
19:8 error Identifier 'value_nodes' is not in camel case camelcase
```

The error occurred in `examples/slider/js/text-slider.js`, on line 19 and the
offending character is indicated by the number `8` after the colon. Change the
variable `value_nodes` to `valueNodes` in your source file to eliminate this
error.

To see the complete list of style rules that are applied by ESLint, review the [.eslint.json](https://github.com/w3c/aria-practices/blob/master/.eslint.json) file in the root of the project.

### Editorial documentation

General documentation for editing ARIA deliverables is available in the
[ARIA repository](https://github.com/w3c/aria/).
Some of that documentation covers technical procedures not needed
for this specification.

## How to update document snapshot

Note: These instructions are for editors of the APG who have repository commit access.

1. Go to the [editors draft on rawgit](https://cdn.rawgit.com/w3c/aria-practices/master/aria-practices.html)
2. Press the ReSpec button (top right hand corner)
3. Select 'Save snapshot'
Expand Down
74 changes: 45 additions & 29 deletions common/acknowledgements.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,46 +4,41 @@ <h3>Acknowledgments</h3>
<section class="section" id="ack_group">
<h4>Participants active in the ARIA WG at the time of publication</h4>
<ul>
<li>Ann Abbott (IBM Corporation)</li>
<li>Ann Abbott (Invited Expert)</li>
<li>Irfan Ali (Educational Testing Service)</li>
<li>Amelia Bellamy-Royds (Invited Expert)</li>
<li>Michiel Bijl (Invited Expert)</li>
<li>Christy Blew (University of Illinois at Urbana-Champaign)</li>
<li>David Bolter (Mozilla Foundation) </li>
<li>Michael Cooper (W3C/MIT)</li>
<li>David Bolter (Mozilla Foundation)</li>
<li>Bogdan Brinza (Microsoft Corporation)</li>
<li>Shari Butler (Pearson plc)</li>
<li>Thaddeus Cambron (Invited Expert)</li>
<li>Michael Cooper (W3C Staff)</li>
<li>James Craig (Apple Inc.) </li>
<li>Joanmarie Diggs (Igalia)</li>
<li>Fred Esch (IBM Corporation)</li>
<li>Steve Faulkner (The Paciello Group) </li>
<li>John Foliot (Invited Expert)</li>
<li>John Foliot (Deque Systems, Inc.)</li>
<li>Bryan Garaventa (SSB BART Group)</li>
<li>Matt Garrish (DAISY Consortium)</li>
<li>Billy Gregory (The Paciello Group)</li>
<li>Karl Groves (The Paciello Group)</li>
<li>Becky Gibson (Invited Expert)</li>
<li>Glen Gordon (The Paciello Group, LLC)</li>
<li>Jon Gunderson (University of Illinois at Urbana-Champaign)</li>
<li>Markus Gylling (DAISY Consortium)</li>
<li>Markku Hakkinen (Educational Testing Service)</li>
<li>Katie Haritos-Shea (Knowbility)</li>
<li>Susann Keohane (IBM Corporation)</li>
<li>Matthew King (Facebook)</li>
<li>Jason Kiss (Department of Internal Affairs, New Zealand Government)</li>
<li>Jamie Knight (British Broadcasting Corporation)</li>
<li>JaEun Jemma Ku (University of Illinois at Urbana-Champaign)</li>
<li>Charles LaPierre (Benetech)</li>
<li>Aaron Leventhal (Google, Inc.)</li>
<li>Dominic Mazzoni (Google, Inc.)</li>
<li>Shane McCarron (Invited Expert, Aptest)</li>
<li>Charles McCathie Nevile (Yandex)</li>
<li>Mary Jo Mueller (IBM Corporation)</li>
<li>Jan McSorley (Pearson plc)</li>
<li>James Nurthen (Oracle Corporation) </li>
<li>Ian Pouncey (The Paciello Group, LLC)</li>
<li>Mark Sadecki (Invited Expert)</li>
<li>Ruoxi Ran (W3C Staff)</li>
<li>Janina Sajka (Invited Expert, The Linux Foundation)</li>
<li>Joseph Scheuhammer (Invited Expert, Inclusive Design Research Centre, OCAD University) </li>
<li>Stefan Schnabel (SAP AG) </li>
<li>Richard Schwerdtfeger (IBM Corporation)</li>
<li>Lisa Seeman (Invited Expert) </li>
<li>Stefan Schnabel (SAP SE) </li>
<li>Lisa Seeman-Kestenbaum (Invited Expert) </li>
<li>Tzviya Siegman (Wiley)</li>
<li>Cynthia Shelly (Microsoft Corporation) </li>
<li>Alexander Surkov (Mozilla Foundation)</li>
<li>Léonie Watson (The Paciello Group)</li>
<li>Job van Achterberg (Invited Expert)</li>
<li>Evan Yamanishi (W. W. Norton)</li>
<li>Jason White (Educational Testing Service)</li>
<li>Gottfried Zimmermann (Invited Expert, Access Technologies Group)</li>
</ul>
</section>
<section class="section" id="ack_others">
Expand All @@ -55,6 +50,7 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>David Baron (Mozilla Foundation)</li>
<li>Art Barstow (Nokia Corporation)</li>
<li>Simon Bates</li>
<li>Christy Blew (University of Illinois at Urbana-Champaign)</li>
<li>Chris Blouch (AOL)</li>
<li>Judy Brewer (W3C/MIT)</li>
<li>Mark Birbeck (Sidewinder Labs)</li>
Expand All @@ -72,24 +68,31 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>Micah Dubinko (Invited Expert)</li>
<li>Mandana Eibegger</li>
<li>Beth Epperson (Websense)</li>
<li>Fred Esch (IBM Corporation)</li>
<li>Donald Evans (AOL)</li>
<li>Steve Faulkner (The Paciello Group, LLC) </li>
<li>Chris Fleizach (Apple Inc.)</li>
<li>Kelly Ford (Microsoft Corporation)</li>
<li>Geoff Freed (Invited Expert, NCAM)</li>
<li>Christopher Gallelo (Microsoft Corporation)</li>
<li>Billy Gregory (The Paciello Group, LLC)</li>
<li>Karl Groves (The Paciello Group, LLC)</li>
<li>Birkir Gunnarsson (Deque Systems, Inc.)</li>
<li>Kentarou Fukuda (IBM Corporation)</li>
<li>Bryan Garaventa</li>
<li>Guido Geloso</li>
<li>Ali Ghassemi</li>
<li>Becky Gibson (IBM)</li>
<!--<li>Becky Gibson (IBM)</li>-->
<li>Alfred S. Gilman</li>
<li>Andres Gonzalez (Adobe Systems Inc.)</li>
<li>Scott González (JQuery Foundation)</li>
<li>James Graham</li>
<li>Georgios Grigoriadis (SAP AG)</li>
<li>Jeff Grimes (Oracle)</li>
<li>Loretta Guarino Reid (Google, Inc.)</li>
<li>Markus Gylling (DAISY Consortium)</li>
<li>Markku Hakkinen (Educational Testing Service)</li>
<li>Katie Haritos-Shea (Knowbility)</li>
<li>Barbara Hartel</li>
<li>James Hawkins (Google, Inc.)</li>
<li>Benjamin Hawkes-Lewis</li>
Expand All @@ -98,6 +101,7 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>Jan Heck</li>
<li>Shawn Henry</li>
<li>Tina Homboe</li>
<li>Nicholas Hoyt</li>
<li>John Hrvatin (Microsoft Corporation)</li>
<li>Takahiro Inada</li>
<li>Masayasu Ishikawa (W3C)</li>
Expand All @@ -106,28 +110,35 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>Shilpi Kapoor (BarrierBreak Technologies)</li>
<li>Masahiko Kaneko (Microsoft Corporation)</li>
<li>Marjolein Katsma</li>
<li>Susann Keohane (IBM Corporation)</li>
<li>George Kerscher (International Digital Publishing Forum)</li>
<li>Jason Kiss (New Zealand Government)</li>
<li>Jason Kiss (Department of Internal Affairs, New Zealand Government)</li>
<li>Todd Kloots</li>
<li>Jamie Knight (British Broadcasting Corporation)</li>
<li>Johannes Koch</li>
<li>Gerard K. Cohen</li>
<li>Sam Kuper</li>
<li>Earl Johnson (Sun)</li>
<li>Jael Kurz</li>
<li>Rajesh Lal (Nokia Corporation)</li>
<li>Diego La Monica (International Webmasters Association / HTML Writers Guild (IWA-HWG))</li>
<li>Aaron Leventhal (IBM Corporation)</li>
<!--<li>Aaron Leventhal (IBM Corporation)</li>-->
<li>Gez Lemon (International Webmasters Association / HTML Writers Guild (IWA-HWG))</li>
<li>Alex Li (SAP)</li>
<li>Chris Lilley</li>
<li>Thomas Logan (HiSoftware Inc.)</li>
<li>Brian Loh</li>
<li>William Loughborough (Invited Expert)</li>
<li>Linda Mao (Microsoft)</li>
<li>David MacDonald (Invited Expert, CanAdapt Solutions Inc.)</li>
<li>Carolyn MacLeod</li>
<li>Anders Markussen (Opera Software)</li>
<li>Krzysztof Maczyński </li>
<li>Matthew May (Adobe Systems Inc.)</li>
<li>Dominic Mazzoni (Google, Inc.)</li>
<li>Mark McCarthy</li>
<li>Charles McCathie Nevile (Yandex)</li>
<li>Heather Migliorisi (Invited Expert)</li>
<li>Mary Jo Mueller (IBM Corporation)</li>
<li>Alexandre Morgaut (4D)</li>
<li>Ann Navarro (Invited Expert)</li>
<li>Joshue O Connor (Invited Expert, CFIT)</li>
Expand All @@ -150,7 +161,10 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>Mario Sánchez Prada (Samsung Electronics Co., Ltd. and Gnome Foundation)</li>
<li>Martin Schaus (SAP AG)</li>
<li>Doug Schepers (W3C)</li>
<li>Cynthia Shelly (Microsoft Corporation) </li>
<li>Joseph Scheuhammer (Invited Expert, Inclusive Design Research Centre, OCAD University) </li>
<li>Matthias Schmitt </li>
<li>Richard Schwerdtfeger (IBM, Knowbility)</li>
<li>Marc Silbey (Microsoft Corporation)</li>
<li>Leif Halvard Sili</li>
<li>Henri Sivonen (Mozilla)</li>
Expand All @@ -168,12 +182,14 @@ <h4>Other ARIA contributors, commenters, and previously active participants</h4>
<li>David Todd</li>
<li>Gregg Vanderheiden (Invited Expert, Trace)</li>
<li>Anne van Kesteren</li>
<li>Léonie Watson (The Paciello Group, LLC)</li>
<li>Wen He (Tencent)</li>
<li>Wu Wei (W3C / RITT)</li>
<li>Ryan Williams (Oracle)</li>
<li>Tom Wlodkowski</li>
<li>Sam White (Apple Inc.)</li>
<li>Marco Zehe (Mozilla Foundation)</li>
<li>Gottfried Zimmermann (Invited Expert, Access Technologies Group)</li>
</ul>
</section>
<section class="section" id="ack_funders">
Expand Down
Loading

0 comments on commit 4182fa3

Please sign in to comment.