Rename rules and reorganize documentation. (#37)

* [rename] - Rename aria-role-supports-attribute to role-supports-aria-props

* [rename] - rename avoid-positive-tabindex to tabindex-no-positive

* [rename] - rename img-uses-alt to img-has-alt

* [rename] - rename label-uses-for to label-has-for

* [rename] - rename mouse-events-map-to-key-events to mouse-events-have-key-events

* [rename] - rename no-hash-href to href-no-hash

* [rename] - no-invalid-aria to aria-props

* [rename] - Rename no-unsupported-elements-use-aria to aria-unsupported-elements

* [rename] - Rename onclick-uses-role to onclick-has-role

* [rename] - Rename redundant-alt to img-redundant-alt

* [rename] - Rename use-onblur-not-onchange to no-onchange

* [rename] - Rename valid-aria-role to aria-role

* [rename] - Rename rule valid-aria-proptypes to aria-proptypes

* [rename] - Rename role-requires-aria to role-has-required-aria-props

* [cleanup] - Clean up READMEs and alphabetize rules.

Author: beefancohen

README.md

@@ -70,22 +70,22 @@ Then configure the rules you want to use under the rules section.
 
 ## Supported Rules
 
-- [aria-role-supports-attribute](docs/rules/aria-role-supports-attribute.md): Enforce that elements with explicit or implicit roles defined contain only `aria-*` properties supported by that `role`.
-- [avoid-positive-tabindex](docs/rules/avoid-positive-tabindex.md): Enforce `tabIndex` value is not greater than zero.
-- [img-uses-alt](docs/rules/img-uses-alt.md): Enforce that `<img>` JSX elements use the `alt` prop.
-- [label-uses-for](docs/rules/label-uses-for.md): Enforce that `<label>` elements have the `htmlFor` prop.
-- [mouse-events-map-to-key-events](docs/rules/mouse-events-map-to-key-events.md): Enforce that `onMouseOver`/`onMouseOut` are accompanied by `onFocus`/`onBlur` for keyboard-only users.
+- [aria-props](docs/rules/aria-props.md): Enforce all `aria-*` props are valid.
+- [aria-proptypes](docs/rules/aria-proptypes.md): Enforce ARIA state and property values are valid.
+- [aria-role](docs/rules/aria-role.md): Enforce that elements with ARIA roles must use a valid, non-abstract ARIA role.
+- [aria-unsupported-elements](docs/rules/aria-unsupported-elements.md): Enforce that elements that do not support ARIA roles, states, and properties do not have those attributes.
+- [href-no-hash](docs/rules/href-no-hash.md): Enforce an anchor element's `href` prop value is not just `#`.
+- [img-has-alt](docs/rules/img-has-alt.md): Enforce that `<img>` JSX elements use the `alt` prop.
+- [img-redundant-alt](docs/rules/img-redundant-alt.md): Enforce `<img>` alt prop does not contain the word "image", "picture", or "photo".
+- [label-has-for](docs/rules/label-has-for.md): Enforce that `<label>` elements have the `htmlFor` prop.
+- [mouse-events-have-key-events](docs/rules/mouse-events-have-key-events.md): Enforce that `onMouseOver`/`onMouseOut` are accompanied by `onFocus`/`onBlur` for keyboard-only users.
 - [no-access-key](docs/rules/no-access-key.md): Enforce that the `accessKey` prop is not used on any element to avoid complications with keyboard commands used by a screenreader.
-- [no-hash-href](docs/rules/no-hash-href.md): Enforce an anchor element's `href` prop value is not just `#`.
-- [no-invalid-aria](docs/rules/no-invalid-aria.md): Enforce all `aria-*` props are valid.
-- [no-unsupported-elements-use-aria](docs/rules/no-unsupported-elements-use-aria.md): Enforce that elements that do not support ARIA roles, states, and properties do not have those attributes.
+- [no-onchange](docs/rules/no-onchange.md): Enforce that `onBlur` is used instead of `onChange`.
 - [onclick-has-focus](docs/rules/onclick-has-focus.md): Enforce that elements with `onClick` handlers must be focusable.
-- [onclick-uses-role](docs/rules/onclick-uses-role.md): Enforce that non-interactive, visible elements (such as `<div>`) that have click handlers use the role attribute.
-- [redundant-alt](docs/rules/redundant-alt.md): Enforce `<img>` alt prop does not contain the word "image", "picture", or "photo".
-- [role-requires-aria](docs/rules/role-requires-aria.md): Enforce that elements with ARIA roles must have all required attributes for that role.
-- [use-onblur-not-onchange](docs/rules/use-onblur-not-onchange.md): Enforce that `onBlur` is used instead of `onChange`.
-- [valid-aria-proptype](docs/rules/valid-aria-proptype.md): Enforce ARIA state and property values are valid.
-- [valid-aria-role](docs/rules/valid-aria-role.md): Enforce that elements with ARIA roles must use a valid, non-abstract ARIA role.
+- [onclick-has-role](docs/rules/onclick-has-role.md): Enforce that non-interactive, visible elements (such as `<div>`) that have click handlers use the role attribute.
+- [role-has-required-aria-props](docs/rules/role-has-required-aria-props.md): Enforce that elements with ARIA roles must have all required attributes for that role.
+- [role-supports-aria-props](docs/rules/role-supports-aria-props.md): Enforce that elements with explicit or implicit roles defined contain only `aria-*` properties supported by that `role`.
+- [tabindex-no-positive](docs/rules/tabindex-no-positive.md): Enforce `tabIndex` value is not greater than zero.
 
 ## License
 

docs/rules/no-invalid-aria.md renamed to docs/rules/aria-props.md

@@ -1,4 +1,4 @@
-# no-invalid-aria
+# aria-props
 
 Elements cannot use an invalid ARIA attribute. This will fail if it finds an `aria-*` property that is not listed in [WAI-ARIA States and Properties spec](https://www.w3.org/TR/wai-aria/states_and_properties#state_prop_def).
 

docs/rules/valid-aria-proptype.md renamed to docs/rules/aria-proptypes.md

@@ -1,4 +1,4 @@
-# valid-aria-proptype
+# aria-proptypes
 
 ARIA state and property values must be valid.
 

docs/rules/valid-aria-role.md renamed to docs/rules/aria-role.md

@@ -1,4 +1,4 @@
-# valid-aria-role
+# aria-role
 
 Elements with ARIA roles must use a valid, non-abstract ARIA role. A reference to all role defintions can be found at [WAI-ARIA](https://www.w3.org/TR/wai-aria/roles#role_definitions) site.
 

docs/rules/no-unsupported-elements-use-aria.md renamed to docs/rules/aria-unsupported-elements.md

@@ -1,4 +1,4 @@
-# no-unsupported-elements-use-aria
+# aria-unsupported-elements
 
 Certain reserved DOM elements do not support ARIA roles, states and properties. This is often because they are not visible, for example `meta`, `html`, `script`, `style`. This rule enforces that these DOM elements do not contain the `role` and/or `aria-*` props.
 

docs/rules/no-hash-href.md renamed to docs/rules/href-no-hash.md

@@ -1,4 +1,4 @@
-# no-hash-href
+# href-no-hash
 
 Enforce an anchor element's href prop value is not just #. You should use something more descriptive, or use a button instead.
 
@@ -26,8 +26,8 @@ To tell this plugin to also check your `Link` element, specify this in your `.es
 ```json
 {
     "rules": {
-        "jsx-a11y/no-hash-href": [ 2, "Link" ], // OR
-        "jsx-a11y/no-hash-href": [ 2, [ "Link", "Anchor" ] ]
+        "jsx-a11y/href-no-hash": [ 2, "Link" ], // OR
+        "jsx-a11y/href-no-hash": [ 2, [ "Link", "Anchor" ] ]
     }
 }
 ```

docs/rules/img-uses-alt.md renamed to docs/rules/img-has-alt.md

@@ -1,4 +1,4 @@
-# img-uses-alt
+# img-has-alt
 
 Enforce that an `img` element contains the `alt` prop. The `alt` attribute specifies an alternate text for an image, if the image cannot be displayed.
 
@@ -35,8 +35,8 @@ To tell this plugin to also check your `Image` element, specify this in your `.e
 ```json
 {
     "rules": {
-        "jsx-a11y/img-uses-alt": [ 2, "Image" ], <!-- OR -->
-        "jsx-a11y/img-uses-alt": [ 2, [ "Image", "Avatar" ] ]
+        "jsx-a11y/img-has-alt": [ 2, "Image" ], <!-- OR -->
+        "jsx-a11y/img-has-alt": [ 2, [ "Image", "Avatar" ] ]
     }
 }
 ```

docs/rules/redundant-alt.md renamed to docs/rules/img-redundant-alt.md

@@ -1,4 +1,4 @@
-# redundant-alt
+# img-redundant-alt
 
 Enforce img alt attribute does not contain the word image, picture, or photo. Screenreaders already announce `img` elements as an image. There is no need to use words such as *image*, *photo*, and/or *picture*.
 

docs/rules/label-uses-for.md renamed to docs/rules/label-has-for.md

@@ -1,4 +1,4 @@
-# label-uses-for
+# label-has-for
 
 Enforce label tags have htmlFor attribute. Form controls using a label to identify them must have only one label that is programmatically associated with the control using: label htmlFor=[ID of control].
 
@@ -36,8 +36,8 @@ To tell this plugin to also check your `Label` element, specify this in your `.e
 ```json
 {
     "rules": {
-        "jsx-a11y/label-uses-for": [ 2, "Label" ], // OR
-        "jsx-a11y/label-uses-for": [ 2, [ "Label", "InputDescriptor" ] ]
+        "jsx-a11y/label-has-for": [ 2, "Label" ], // OR
+        "jsx-a11y/label-has-for": [ 2, [ "Label", "InputDescriptor" ] ]
     }
 }
 ```

docs/rules/mouse-events-map-to-key-events.md renamed to docs/rules/mouse-events-have-key-events.md

@@ -1,4 +1,4 @@
-# mouse-events-map-to-key-events
+# mouse-events-have-key-events
 
 Enforce onmouseover/onmouseout are accompanied by onfocus/onblur. Coding for the keyboard is important for users with physical disabilities who cannot use a mouse, AT compatability, and screenreader users.