added Motivation doc

added  docs/motivation and updated read

Author: allenwb

README.md

@@ -2,6 +2,10 @@
 
 ## Motivation
 
+This is new proposal for extending ECMAScript class definition syntax and semantics. It is intend to a replacement for the  set of proposals currently under development within TC39. For the motivation for developing a new proposal see [Why A new Proposal](docs/motivation.md).
+
+## Goals
+
 The max-min class design, as implemented in ECMAScript 2018, has successfully balanced the need for a declarative class syntax with the desire to keep semantics lightweight and expressible in terms of the existing Javascript object model. Although there are currently several proposals for extending class definitions with additional features, we believe that existing class definitions are only missing the following fundamental capabilities:
 
 1. **Per-instance encapsulated state.** There should be a way for a class author to specify per-instance state that is not accessible outside of the class definition.

docs/motivation.md

@@ -0,0 +1,27 @@
+# Why A New Proposal
+
+## Motivation
+
+TC39 has been working on proposals to extend the current class definition syntax and semantics since before ES2015 was completed. These proposal have been created by different authors and on different time scales. While there have been attempts to coordinate and integrate the proposals, the overall result is a large set of distinct features with complex interactions among themselves and the already standardized features of the language. There has been significant concerns raised about the overall complexity both by community members and from TC39 members. One major syntactic choice (the # prefix for private members) have proven to be particular concerning to many community members.
+
+Yet TC39 has continued to move forward with these proposals with some of them reaching Stage 3 of the TC39 process. Even with the negative community feedback and the internal concerns the incorporation of the current proposal into the standard seems inevitable. There is great reluctance among members to break consensus and there are no serious alternatives on the table that a new consensus could form around.
+
+The purpose of this proposal is to provided such an alternative that eliminates the complexity and community concern about the current proposals.  We hope that TC39 will use the new proposal as an opportunity to reevaluate both the goals and current approach to extending ECMAScirpt class definitions.
+
+## Approach
+
+We decided to not just take the existing proposals and try to tweak them to eliminate problems.  Instead we started with a clean slate (the ES2015 class definition syntax and semantics), defined  goals and requirements for extending ES2015 class definitions, and tried to create a new unified design that satisfies them. In developing the new design we were informed by the work done for the existing proposal and the feedback but we were not constrained the existing proposals' design decisions.
+
+We want a design that feels right for JavaScript.  We don't feel compelled to duplicate the class functionality of Java, Ruby, Smalltalk, or any other language. We don't believe we must (or can)  satisfy every feature request or every imaginable use case for classes. We just need to provide a design that usefully enhances the capability of JavaScript for now and the foreseeable future.
+
+## Design Rules
+
+We identified a set of design rules that we have followed in developing our proposal. The set of extensions in this proposal should:
+
+0. focus on fundamental capabilities that require engine level support
+1. be as small as possible
+2. support an user conceptual model that is as simple as possible (ie, be easy to teach and understand)
+3. be internally consistent, with few, if any, special cases or unexpected feature interactions
+4. have a pleasant, usable, and uncontroversial syntax
+5. allow transpiler-based dialects by being syntactically orthogonal to known existing class extension. 
+6. be complete.  We don't expect to have to add of any new kinds of class elements in the foreseeable future.