Add readme

README.md

@@ -1,5 +1,32 @@
-> [!WARNING]
-> This repo will eventually be public
+![](./banner.png)
+
+# Cohere Developer Experience
+
+At Cohere we aim to maximise developer productivity by meeting developers at their existing workflows: whether you want to use our model on our platform or on an external cloud platform, our aim is to provide the best experience available.
+
+This repository is a one-stop-shop for Cohere developer experience. Here you can find docs, snippets, api specs and more to help you devlop on the Cohere platform, or on AWS, Azure, OCI, or cohere-toolkit.
+
+## How to use this repository
+
+This repository is organized into the following sections:
+
+- `fern/` contains content and configuration for https://docs.cohere.com
+- `cohere-openapi.yaml` contains the OpenAPI spec for the Cohere platform API
+- `snippets/` contains code snippets for using Cohere in various environments
+
+## Other developer resources
+
+### SDKs
+
+We support the following SDKs which can be used to interact with the Cohere platform and cloud providers:
+
+- [Python](https://github.com/cohere-ai/cohere-python)
+- [Typescript](https://github.com/cohere-ai/cohere-typescript)
+- [Java](https://github.com/cohere-ai/cohere-java)
+- [golang](https://github.com/cohere-ai/cohere-go)
+
+
+## How to contribute to this repository
+
+We welcome contributions to this repository! Feel free to pull request any of the content you see and we will work with you to merge it. The OpenAPI sepcs and snippets are one-way synced from our internal repositories so we will need to take your changes and merge them behind the scenes.
 
-# cohere-developer-experience
-Docs, Snippets, Guides