Merge pull request #32 from openapi-json-schema-tools/improves_readme_intro

Readme update

Author: spacether

README.md

@@ -17,11 +17,47 @@
 </div>
 
 ## Overview
-OpenAPI JSON Schema Generator allows auto-generation of API client libraries (SDK generation) with a focus on JSON Schema given an [OpenAPI Spec](https://github.com/OAI/OpenAPI-Specification) (3.0.0-3.0.3 are supported). Currently, the following languages/frameworks are supported:
+OpenAPI JSON Schema Generator allows auto-generation of API client libraries (SDK generation) given an
+[OpenAPI Spec](https://github.com/OAI/OpenAPI-Specification) (3.0.0-3.0.3 are supported).
+This project focuses on making the output 100% compliant with openapi + JSON schema specs.
+The goal is to fully support everything defined in openapi + the included JSON schema specs
+so developers can use all of those features.
+
+Currently, the following languages/frameworks are supported:
 
 - python
 
-## Can I build here?
+## Reasons To Use the Python Generator
+
+- [Autogenerated thorough testing of json schema keyword features in models and endpoints](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/tree/master/samples/openapi3/client/3_0_3_unit_test/python/test) which come from the [json schema test suite](https://github.com/json-schema-org/JSON-Schema-Test-Suite) 
+- [Tests are passing in CI](https://app.circleci.com/pipelines/github/openapi-json-schema-tools/openapi-json-schema-generator?branch=master)
+- [Test endpoints are tagged by the relevant keyword like type/format/allOf 25+ keywords and counting](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/tree/master/samples/openapi3/client/3_0_3_unit_test/python/docs/apis/tags)
+- Run time type checking and validation checking when:
+  - instantiating models
+  - sending to endpoints
+  - receiving from endpoints
+- Type hints for all model inputs
+- Type hints for accessing properties in object instances so some_val in some_val = some_inst['someKey'] will have the correct type hint
+- Type hints for accessing array items in array instances so some_val in some_val = array_inst[0] will have the correct type hint
+- Endpoints have input and response type hints
+- Openapi spec inline schemas supported at any depth
+- If needed, validation of some json schema keywords can be deactivated via a configuration class
+- Payload values are not coerced when validated, so a datetime value can pass other validations that describe the payload only as type string
+- String transmission of numbers supported with type: string, format: number, value can be accessed as a Decimal with inst.as_decimal_oapg
+- Format support for: int32, int64, float, double, binary, date, datetime
+- Multiple content types supported for request and response bodies
+- Endpoint response always also includes the urllib3.HTTPResponse
+- Endpoint response deserialization can be skipped with the skip_deserialization argument
+- Invalid (in python) property names supported like self, from etc
+
+And many more!
+- [Docs for the python generator](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/blob/master/docs/generators/python.md)
+- [Openapi json schema v3.0.3 unit test spec](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/blob/master/modules/openapi-json-schema-generator/src/test/resources/3_0/unit_test_spec/3_0_3_unit_test_spec.yaml)
+  - [genrated client sample code](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/tree/master/samples/openapi3/client/3_0_3_unit_test/python)
+- [Openapi v3.0.3 general petstore spec, general features](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/blob/master/modules/openapi-json-schema-generator/src/test/resources/3_0/python/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml)
+  - [genrated client sample code](https://github.com/openapi-json-schema-tools/openapi-json-schema-generator/tree/master/samples/openapi3/client/petstore/python)
+
+### Can I build here?
 
 Yes! Contributions are welcome.
 If you want to build a new server or client or documentation generator you are welcome to here.