update docs 1

docs/source/_toctree.yml

@@ -1,8 +1,10 @@
 - sections: 
   - local: index
     title: 🤗 Competitions
-  - local: getting_started
-    title: Getting started
   - local: pricing
     title: Pricing
   title: Get started
+- sections:
+  - local: create_competition
+    title: Create competition
+  title: Create competition

docs/source/create_competition.mdx

@@ -0,0 +1,23 @@
+# Create a competition
+
+Creating a competition is super easy and you have full control over the data, evaluation metric and the hardware used.
+
+To create a competition, you need to have a [Hugging Face](https://huggingface.co) account. You will also need a write token which will be used throughout the competition to upload data and submissions.
+Please note that the write token is private and should not be shared with anyone and must not be refreshed during the course of the competition.
+In case you decide to refresh the token, you will need to update the token in the competition space's settings otherwise the competitors will not be able to upload submissions and competition will stop working.
+You can find/generate a write token [here](https://huggingface.co/settings/tokens).
+
+To create a competition, you also need an organization. You can either create a new organization or use an existing one that you are already a member of.
+You can create a new organization [here](https://huggingface.co/organizations/new).
+
+Please make sure you attach a payment method to your organization. You can do so in organization settings.
+NOTE: your payment method will not be charged if you are using the free tier of the platform (generic competitions hosted on CPU).
+
+To create a competition, click [here](https://huggingface.co/spaces/competitions/create).
+
+## Competition creator
+
+![competition](https://github.com/abhishekkrthakur/public_images/blob/main/competition_creator.png?raw=true)
+
+Please note: you will be able to change almost every setting later on. However, we dont recommend changing evaluation metric once the competition has started.
+As it will require you to re-evaluate all the submissions.

docs/source/getting_started.mdx

@@ -1,19 +0,0 @@
-# Getting started
-
-## Installation
-
-```bash
-pip install competitions
-```
-
-## Creating a competition
-
-```bash
-competitions create
-```
-
-Then follow the prompts.
-
-To report a bug or request a feature, please open an [issue](https://github.com/huggingface/competitions/issues)
-
-If you want to organize a competition on hf.co/competitions, please contact us at: autotrain@hf.co

docs/source/index.mdx

@@ -2,6 +2,10 @@
 
 Create a machine learning competition for your organization, friends or the world!
 
+![competition](https://github.com/abhishekkrthakur/public_images/blob/main/competition_page.png?raw=true)
+
+## Supported competition types
+
 There are two types of competitions you can create:
 
 - generic: a competition where you provide the data and the participants provide the predictions as a CSV file. all the test data is always available to the participants.
@@ -10,3 +14,21 @@ There are two types of competitions you can create:
 
 You can choose to make your competition public or private. Public competitions are visible to everyone and anyone can participate. Private competitions are only visible to the people you invite!
 
+## Why choose Hugging Face Competitions?
+
+- you can create totally private competitions that are only visible to the people you invite.
+
+- generic competition can be hosted for free.
+
+- script competitions have a variety of compute options to choose from: CPU, T4, A10g & even A100.
+
+- you have full control over the data you want to use for your competition.
+
+- its open source!
+
+
+## Issues / feature requests
+
+Something missing? Found a bug? Please open an issue on this [GitHub repository](https://github.com/huggingface/competitions) and we'll fix it as soon as possible!
+
+To host competition on hf.co/competitions, please contact us at autotrain [at] huggingface [dot] co