Add instructions to README

README.md

@@ -9,7 +9,44 @@ Cognite Simulator Integration Utils
 [![codecov](https://codecov.io/gh/cognitedata/dotnet-simulator-utils/branch/main/graph/badge.svg?token=sr1aNhkc1e)](https://codecov.io/gh/cognitedata/dotnet-simulator-utils)
 [![Nuget](https://img.shields.io/nuget/vpre/Cognite.Simulator.Extensions)](https://www.nuget.org/packages/Cognite.Simulator.Extensions/)
 
-Utilities for developing simulator integrations within CDF 
+Utilities for developing simulator integrations within CDF. This contains extendable common utilities that can be used by simulator connectors to interact with CDF APIs and the simulator. 
+
+# Getting started 
+
+To build a new connector based upon these utilities, just add a reference to this library in your project's csproj file:
+
+`dotnet add package Cognite.Simulator.Utils`
+
+[Latest version can be obtained from Nuget](https://www.nuget.org/packages/Cognite.Simulator.Utils/)
+
+# For local development
+
+Clone this repo locally then add a reference to a local version of this repository to your `csproj` file:
+
+````
+  <ItemGroup>
+      <ProjectReference Include="../../dotnet-simulator-utils/Cognite.Simulator.Utils/Cognite.Simulator.Utils.csproj" />
+  </ItemGroup>
+````
+
+After this run `dotnet build` in your project folder. Next start extending existing utilities in your project. [Use the DWSIM project as an example](https://github.com/cognitedata/dwsim-connector-dotnet).
+
+# Running Tests
+
+Create an `.envrc` file containing the CDF connection credentials. The file's format should be :
+
+````
+export COGNITE_HOST="" #Example: https://westeurope-1.cognitedata.com
+export COGNITE_PROJECT="" #Example: cognite-simulator-integration
+export AZURE_TENANT=""
+export AZURE_CLIENT_ID=""
+export AZURE_CLIENT_SECRET=""
+
+````
+
+Then run a `source .envrc` to load the environment variables into your current terminal session
+
+Finally, run `dotnet test`
 
 # Code of Conduct