update readme

README.md

@@ -1,2 +1,24 @@
 # terraform-sample
-Sample to help you get started with onboarding Terraforms to IBM Cloud
+## Contents:
+1. [Overview](#overview)
+2. [Prerequisites](#prerequisites)
+
+****
+## Overview
+
+This repository contains a sample Terraform that helps you understand how to prepare your Terraform for onboarding to IBM Cloud. 
+
+## Prerequisites
+
+Make sure that you complete the following prerequisites before you begin:
+
+1. Verify that you're using a Pay-As-You-Go or Subscription account. See [Viewing your account type](https://cloud.ibm.com/docs/account?topic=account-account_settings#view-acct-type) for more details.
+
+2. Verify that you're assigned the following roles. For more information, see [Assigning access to account management services](https://cloud.ibm.com/docs/account?topic=account-account-services) and [Managing access to resources](https://cloud.ibm.com/docs/account?topic=account-assign-access-resources).
+
+   - administrator role on all account management services and all IAM-enabled services
+   - editor role on the catalog management service
+
+3. Create your [Terraform template](https://cloud.ibm.com/docs/schematics?topic=schematics-create-tf-config).
+
+4. Upload your Terraform template and readme file to your GitHub repository.