added README in markdown format (#41)

Signed-off-by: Ali Mukadam <[email protected]>

Author: hyder

README.md

@@ -0,0 +1,81 @@
+# Terraform Base for Oracle Cloud Infrastructure
+
+[changelog]: https://github.com/oracle/terraform-oci-base/CHANGELOG.adoc
+[contributing]: https://github.com/oracle/terraform-oci-base/CONTRIBUTING.adoc
+[contributors]: https://github.com/oracle/terraform-oci-base/CONTRIBUTORS.adoc
+[docs]: https://github.com/oracle/terraform-oci-base/docs
+
+[instance_principal]: https://github.com/oracle/terraform-oci-base/docs/instanceprincipal.adoc
+
+[license]: https://github.com/oracle/terraform-oci-base/docs/LICENSE
+[canonical_license]: https://oss.oracle.com/licenses/upl/
+
+[oci]: https://cloud.oracle.com/cloud-infrastructure
+[oci_documentation]: https://docs.cloud.oracle.com/iaas/Content/home.htm
+
+[ons]: https://github.com/oracle/terraform-oci-base/docs/notifications.adoc
+[oracle]: https://www.oracle.com
+[prerequisites]: https://github.com/oracle/terraform-oci-base/docs/prerequisites.adoc
+[quickstart]: https://github.com/oracle/terraform-oci-base/docs/quickstart.adoc
+[repo]: https://github.com/oracle/terraform-oci-base
+[reuse]: https://github.com/oracle/terraform-oci-base/examples/db
+[subnets]: https://erikberg.com/notes/networks.html
+[terraform]: https://www.terraform.io
+[terraform_cidr_subnet]: http://blog.itsjustcode.net/blog/2017/11/18/terraform-cidrsubnet-deconstructed/
+[terraform_hashircorp_examples]: https://github.com/hashicorp/terraform-guides/tree/master/infrastructure-as-code/terraform-0.12-examples
+[terraform_oci]: https://www.terraform.io/docs/providers/oci/index.html
+[terraform_options]: https://github.com/oracle/terraform-oci-base/docs/terraformoptions.adoc
+[terraform_oci_examples]: https://github.com/terraform-providers/terraform-provider-oci/tree/master/examples
+[terraform_oci_oke]: https://github.com/oracle-terraform-modules/terraform-oci-oke
+
+The [Terraform OCI Base module][repo] for [Oracle Cloud Infrastructure (OCI)][oci] provides a reusable [Terraform][terraform] module that provisions a minimal infrastructure on OCI.
+
+It creates the following resources:
+
+* A VCN, along with optional NAT, Internet and service gateways
+* An optional bastion host
+* An optional private admin host where privileged actions can be performed
+
+The module can be reused to create more advanced infrastructure on [OCI][oci] either manually in the OCI Console or by extending the Terraform code.
+
+## [Documentation][docs]
+
+### [Pre-requisites][prerequisites]
+
+#### Instructions
+- [Provisioning a basic infrastructure (Quickstart)][quickstart]
+- [Reusing as a Terraform module][reuse]
+- [Enabling instance_principal][instance_principal]
+- [Using ONS Notification][ons]
+- [Terraform Options][terraform_options]
+
+## Related Documentation, Blog
+- [Oracle Cloud Infrastructure Documentation][oci_documentation]
+- [Terraform OCI Provider Documentation][terraform_oci]
+- [Erik Berg on Networks, Subnets and CIDR][subnets]
+- [Lisa Hagemann on Terraform cidrsubnet Deconstructed][terraform_cidr_subnet]
+
+## Projects using this module
+- [terraform-oci-oke][terraform_oci_oke]
+
+## Changelog
+
+View the [CHANGELOG][changelog].
+
+## Acknowledgement
+
+Code derived and adapted from [Terraform OCI Examples][terraform_oci_examples] and Hashicorp's [Terraform 0.12 examples][terraform_oci_examples]
+
+## Contributors
+
+[Folks who contributed with explanations, code, feedback, ideas, testing etc.][contributors]
+
+Learn how to [contribute][contributing].
+
+== License
+
+Copyright © 2019 Oracle and/or its associates. All rights reserved.
+
+Licensed under the [Universal Permissive License 1.0][license] as shown at 
+[https://oss.oracle.com/licenses/upl][canonical_license].
+