Repo boilerplate

Mostly copied from the source_gen repo

- Initial README with example
- LICENSE, AUTHORS, CONTRIBUTING
- .gitignore

Author: natebosch

Diff for: .gitignore

@@ -0,0 +1,5 @@
+.dart_tool
+.packages
+.pub
+packages
+pubspec.lock

Diff for: AUTHORS

@@ -0,0 +1,6 @@
+# Below is a list of people and organizations that have contributed
+# to the project. Names should be added to the list like so:
+#
+#   Name/Organization <email address>
+
+Google Inc.

Diff for: CONTRIBUTING.md

@@ -0,0 +1,33 @@
+Want to contribute? Great! First, read this page (including the small print at
+the end).
+
+### Before you contribute
+Before we can use your code, you must sign the
+[Google Individual Contributor License Agreement](https://cla.developers.google.com/about/google-individual)
+(CLA), which you can do online. The CLA is necessary mainly because you own the
+copyright to your changes, even after your contribution becomes part of our
+codebase, so we need your permission to use and distribute your code. We also
+need to be sure of various other things—for instance that you'll tell us if you
+know that your code infringes on other people's patents. You don't have to sign
+the CLA until after you've submitted your code for review and a member has
+approved it, but you must do it before we can put your code into our codebase.
+
+Before you start working on a larger contribution, you should get in touch with
+us first through the issue tracker with your idea so that we can help out and
+possibly guide you. Coordinating up front makes it much easier to avoid
+frustration later on.
+
+### Code reviews
+All submissions, including submissions by project members, require review.
+
+### File headers
+All files in the project must start with the following header.
+
+    // Copyright (c) 2015, the Dart project authors.  Please see the AUTHORS file
+    // for details. All rights reserved. Use of this source code is governed by a
+    // BSD-style license that can be found in the LICENSE file.
+
+### The small print
+Contributions made by corporations are covered by a different agreement than the
+one above, the
+[Software Grant and Corporate Contributor License Agreement](https://developers.google.com/open-source/cla/corporate).

Diff for: LICENSE

@@ -0,0 +1,26 @@
+Copyright 2017, the Dart project authors. All rights reserved.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Google Inc. nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Diff for: README.md

@@ -0,0 +1,56 @@
+# json_serializable
+
+## Overview
+
+`json_serializable` provides `source_gen` `Generator`s which generate code to
+make it simple to serialize to and from JSON.
+
+## Example
+
+Given a library `example.dart` with an `Person` class annotated with
+`@JsonSerializable`:
+
+```dart
+library source_gen.example;
+
+import 'package:source_gen/generators/json_serializable.dart';
+part 'example.g.dart';
+
+@JsonSerializable()
+class Person extends Object with _$PersonSerializerMixin {
+  final String firstName, middleName, lastName;
+
+  @JsonKey('date-of-birth')
+  final DateTime dateOfBirth;
+
+  Person(this.firstName, this.lastName, {this.middleName, this.dateOfBirth});
+
+  factory Person.fromJson(json) => _$PersonFromJson(json);
+}
+```
+
+`source_gen` creates the corresponding part `example.g.dart`:
+
+```dart
+part of source_gen.example;
+
+Person _$PersonFromJson(Map json) => new Person(
+    json['firstName'], json['lastName'],
+    middleName: json['middleName'],
+    dateOfBirth: json['date-of-birth'] == null
+        ? null
+        : DateTime.parse(json['date-of-birth']));
+
+abstract class _$PersonSerializerMixin {
+  String get firstName;
+  String get middleName;
+  String get lastName;
+  DateTime get dateOfBirth;
+  Map<String, dynamic> toJson() => <String, dynamic>{
+        'firstName': firstName,
+        'middleName': middleName,
+        'lastName': lastName,
+        'date-of-birth': dateOfBirth?.toIso8601String(),
+      };
+}
+```