Add linting for insensitive and inconsiderate language (facebookarchive#2223)

Summary:
**Summary**

This PR, similarly to facebook/react-native-website#1337, adds [alexjs](https://alexjs.com/) linting to Draft.js in order to identify and prevent insensitive and inconsiderate language from landing on master.

- Adds Alex
- Configures Alex rules
- **TODO:** Run Alex in Travis CI

**Test Plan**

- Run `yarn lint-docs`
- Verify there are no lint violations
Pull Request resolved: facebookarchive#2223

Differential Revision: D18046996

Pulled By: claudiopro

fbshipit-source-id: 66ac935720a0b13576e9a133a3d5f8e98cc539cf

Author: Claudio Procida

.alexignore

@@ -0,0 +1,12 @@
+# The Code of Conduct calls out language that can't be used so it's not linted.
+CODE_OF_CONDUCT.md
+
+# The CHANGELOG contains references to commit messages.
+CHANGELOG.md
+
+# We will handle meeting notes and roadmap documents after the main docs are linted.
+meta/meeting-notes/**/*.md
+meta/roadmaps/*.md
+
+# This README contains some domain specific language that fails validation.
+examples/draft-0-10-0/playground/README.md

.alexrc.js

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+exports.allow = [
+  // We frequently refer to form props by their name "disabled".
+  // Ideally we would alex-ignore only the valid uses (PRs accepted).
+  "invalid",
+
+  // Unfortunately "watchman" is a library name that we depend on.
+  "watchman-watchwoman"
+];
+
+// Use a "maybe" level of profanity instead of the default "unlikely".
+exports.profanitySureness = 1;

CONTRIBUTING.md

@@ -1,5 +1,5 @@
 # Contributing to Draft.js
-We want to make contributing to this project as easy and transparent as
+We want to make contributing to this project as approachable and transparent as
 possible.
 
 ## Code of Conduct
@@ -65,7 +65,7 @@ Our philosophy regarding API changes is as follows:
  * In order to avoid stagnation we will allow for API changes in cases where
  there is no other way to achieve a high priority bug fix or improvement.
  * When there is an API change:
-    * Changes will have a clearly documented reason and migration path
+    * Changes will have a well documented reason and migration path
     * When deprecating a pattern, these steps will be followed:
         * We will test the change internally first at FB
         * A version will be released that supports both, with deprecation warnings

README.md

@@ -7,7 +7,7 @@ backed by an immutable model.
 
 - **Extensible and Customizable:** We provide the building blocks to enable
 the creation of a broad variety of rich text composition experiences, from
-simple text styles to embedded media.
+basic text styles to embedded media.
 - **Declarative Rich Text:** Draft.js fits seamlessly into
 [React](http://facebook.github.io/react/) applications,
 abstracting away the details of rendering, selection, and input behavior with a
@@ -138,7 +138,7 @@ Further examples of how Draft.js can be used are provided below.
 
 ### Examples
 
-Visit http://draftjs.org/ to try out a simple rich editor example.
+Visit http://draftjs.org/ to try out a basic rich editor example.
 
 The repository includes a variety of different editor examples to demonstrate
 some of the features offered by the framework.

docs/APIReference-Editor.md

@@ -146,7 +146,7 @@ disabled.
 
 This is useful when supporting interaction within
 [custom block components](/docs/advanced-topics-block-components.html)
-or if you just want to display content for a static use case.
+or if you only want to display content for a static use case.
 
 Default is `false`.
 

docs/APIReference-EditorState.md

@@ -530,7 +530,7 @@ operations.
 When performing operations that modify contents, we determine whether the
 current `ContentState` should be regarded as a "boundary" state that the user
 can reach by performing an undo operation. If so, the `ContentState` is pushed
-onto the `undoStack`. If not, the outgoing `ContentState` is simply discarded.
+onto the `undoStack`. If not, the outgoing `ContentState` is discarded.
 
 You should not manage this property manually. If you would like to disable
 undo/redo behavior, use the `allowUndo` property.

docs/APIReference-Entity.md

@@ -16,7 +16,7 @@ for details on updating your application
 [see our v0.10 API Migration Guide](/docs/v0-10-api-migration.html#content).
 
 Entity objects returned by `Entity` methods are represented as
-[DraftEntityInstance](https://github.com/facebook/draft-js/blob/master/src/model/entity/DraftEntityInstance.js) immutable records. These have a simple set of getter functions and should
+[DraftEntityInstance](https://github.com/facebook/draft-js/blob/master/src/model/entity/DraftEntityInstance.js) immutable records. These have a small set of getter functions and should
 be used only for retrieval.
 
 ## Overview

docs/APIReference-Modifier.md

@@ -113,7 +113,7 @@ insertText(
 ): ContentState
 ```
 Identical to `replaceText`, but enforces that the target range is collapsed
-so that no characters are replaced. This is just for convenience, since text
+so that no characters are replaced. This is only for convenience, since text
 edits are so often insertions rather than replacements.
 
 ### moveText
@@ -136,7 +136,7 @@ replaceWithFragment(
   fragment: BlockMap
 ): ContentState
 ```
-A "fragment" is a section of a block map, effectively just an
+A "fragment" is a section of a block map, effectively only an
 `OrderedMap<string, ContentBlock>` much the same as the full block map of a
 `ContentState` object.
 

docs/Advanced-Topics-Block-Components.md

@@ -117,7 +117,7 @@ The recommendation above is especially important for custom block renderers
 that involve text input, like the TeX editor example.
 
 It is also worth noting that within the Facebook Notes editor, we have not
-tried to perform any special SelectionState rendering or management on embedded
+tried to perform any specific SelectionState rendering or management on embedded
 media, such as rendering a highlight on an embedded photo when selecting it.
 This is in part because of the rich interaction provided on the media
 itself, with resize handles and other controls exposed to mouse behavior.

docs/Advanced-Topics-Custom-Block-Render.md

@@ -65,7 +65,7 @@ class RichEditor extends React.Component {
 }
 ```
 
-There are cases where instead of overwriting the defaults, we just want to add new block types.
+There are cases where instead of overwriting the defaults, we only want to add new block types.
 This can be done by using the DefaultDraftBlockRenderMap reference to create a new blockRenderMap
 
 *example of extending default block render map:*