Updated quickstart

Signed-off-by: Sajay Antony <sajaya@microsoft.com>

docs/quickstart.mdx

@@ -1,58 +1,47 @@
 ---
-title: Introduction to OCI registries, images and artifacts using ORAS
-sidebar_position: 0
+title: Quick Start 
+sidebar_position: 14 
 ---
 
-# Introduction to OCI registries using ORAS
+# Distributing OCI artifacts using ORAS
 
-Before we tackle how to distribute an OCI artifact to an OCI registry, let us first take a look at what we mean by distributing OCI artifacts, why we need it, and what OCI registries are. 
+To distribute OCI artifacts, we need to understand OCI registries. 
+These registries store container images and other artifacts for easy access. 
+Distributing OCI artifacts means pushing them to these registries so others can pull them for use. 
 
-OCI registries are like a single location where container images and other artifacts are stored and made available to everyone. Distributing OCI artifacts refers to when artifacts are pushed to these registries. These artifacts can then be pulled (or retrieved) by someone else and used in their environments. These images often help with packaging and distributing software applications.
+We will be using [zot registry](https://zotregistry.io/) in this guide. 
+Zot registry is an OCI-native container registry for distributing container images and OCI artifacts.
 
-We will be using zot registry in this guide. Zot registry is an OCI-native container registry for distributing container images and OCI artifacts.
+In order to follow the steps given, you would be required to install the ORAS CLI.
+You can follow the [installation guide](./installation.mdx) to do so. 
 
-In order to follow the steps given, you would be required to install the ORAS CLI. You can follow the [installation guide](../installation.mdx) to do so. 
+## Phase 1: Install zot registry 
 
-### Phase 1: To Install Zot Registry 
+We will be running zot using docker. However, you can refer to their [installation guide](https://zotregistry.io/install-guides/install-guide-linux/) to find more ways to install the registry.
 
-We will be installing zot using docker. However, you can refer to their [installation guide](https://zotregistry.io/install-guides/install-guide-linux/) to find more ways to install the registry.
+**Prerequisites**
+- [Docker](https://www.docker.com/) 
 
-Prerequisites for this method:
-* [Docker](https://www.docker.com/) 
-
-```
-docker run -p 5000:5000 ghcr.io/project-zot/zot-linux-amd64:latest
 ```
-
+docker run -d -p 5000:5000 --name oras-quickstart ghcr.io/project-zot/zot-linux-amd64:latest
 ```
-Unable to find image 'ghcr.io/project-zot/zot-linux-amd64:latest' locally
-latest: Pulling from project-zot/zot-linux-amd64
-a7ca0d9ba68f: Pull complete 
-fe5ca62666f0: Pull complete 
 
-<!-- truncated -->
-
-after":"2h0m0s","goroutine":24,"caller":"zotregistry.io/zot/pkg/extensions/extension_search.go:160","time":"2023-05-20T10:50:45.892076536Z"}
-{"level":"debug","component":"scheduler","worker":3,"goroutine":24,"caller":"zotregistry.io/zot/pkg/scheduler/scheduler.go:105","time":"2023-05-20T10:50:45.892089946Z","message":"scheduler: finished task"}
-```
+## Phase 2: Distribution of OCI artifacts
 
+Let's push an OCI artifact to the registry using the ORAS CLI. 
 
-### Phase 2: Distribution of OCI Artifacts to Zot Registry Using Oras CLI
-
-Please open a new terminal window for the next phase.
-
-**Step 1: Create a sample file** 
+### Step 2.1: Create a sample file
 
 ```
 echo "hello world" > artifact.txt
 ```
 
-**Step 2: Pushing artifacts to the zot repository**
+### Step 2.2: Push an artifact
 
-```
+```bash
 oras push --plain-http localhost:5000/hello-artifact:v1 \
-        --artifact-type application/vnd.acme.rocket.config \
-        artifact.txt:text/plain -d -v
+    --artifact-type application/vnd.acme.rocket.config \
+    artifact.txt:text/plain
 ```
 
 ```
@@ -62,42 +51,41 @@ Pushed [registry] localhost:5000/hello-artifact:v1
 Digest: sha256:bcdd6799fed0fca0eaedfc1c642f3d1dd7b8e78b43986a89935d6fe217a09cee
 ```
 
-After pushing the artifact, it can be seen in the zot user interface:
+After pushing the artifact, it can be seen in the zot user interface at [http://localhost:5000/](http://localhost:5000/)
 
-![Screenshot of how the interface should look on pushing](../../static/img/introduction-to-registries-tutorial-zot.png)
+![Screenshot of how the interface should look on pushing](../static/img/introduction-to-registries-tutorial-zot.png)
 
+### Step 2.3: Pull the artifact
 
-**Step 3: Pulling artifacts from the zot repository**
+Let's now pull the artifact we have pushed in the pervious step.
 
 ```
-oras pull --plain-http localhost:5000/hello-artifact:v1 -d -v
+oras pull localhost:5000/hello-artifact:v1
 ```
 
 ```
-DEBU[0000] > Request URL: "http://localhost:5000/v2/hello-artifact/manifests/v1" 
-DEBU[0000] > Request method: "GET"                      
-DEBU[0000] > Request headers: 
-
-<!-- truncated -->
-
+Downloading a948904f2f0f artifact.txt
 Downloaded  a948904f2f0f artifact.txt
-Downloaded  bcdd6799fed0 application/vnd.oci.image.manifest.v1+json
 Pulled [registry] localhost:5000/hello-artifact:v1
-Digest: sha256:bcdd6799fed0fca0eaedfc1c642f3d1dd7b8e78b43986a89935d6fe217a09cee
+Digest: sha256:19e1b5170646a1500a1ac56bad28675ab72dc49038e69ba56eb7556ec478859f
 ```
 
-**Step 4: To attach files to an existing artifact**
+## Phase 3: Attach an artifact
+
+First, let's create another sample file to attach to the previously uploaded artifact. 
 
-First, let's create another sample file to attach to the previously uploaded artifact,
+### Step 3.1: Create a sample file
 
 ```
 echo "hello world" > hi.txt
 ```
 
+### Step 3.2: Attach the file
+
 You can use the command below to attach `hi.txt` to the artifact we pushed above:
 
 ```
-oras attach --plain-http --artifact-type doc/example localhost:5000/hello-artifact:v1 hi.txt
+oras attach --artifact-type doc/example localhost:5000/hello-artifact:v1 hi.txt
 ```
 
 ```
@@ -106,10 +94,10 @@ Attached to [registry] localhost:5000/hello-artifact@sha256:327db68f73d0ed53d528
 Digest: sha256:bcdd6799fed0fca0eaedfc1c642f3d1dd7b8e78b43986a89935d6fe217a09cee
 ```
 
-**Step 5: To check the referrers of the manifest in our zot registry**
+### Step 3.3: View referrers 
 
 ```
-oras discover --plain-http localhost:5000/hello-artifact:v1
+oras discover localhost:5000/hello-artifact:v1
 ```
 
 ```
@@ -120,11 +108,18 @@ Artifact Type   Digest
 doc/example     sha256:bcdd6799fed0fca0eaedfc1c642f3d1dd7b8e78b43986a89935d6fe217a09cee
 ```
 
-**Note:** The  `--plain-http` flag allows connections to the registry without SSL check. As this set up is insecure,
-it can be used for testing purposes. However, you can set up TLS using [these steps](https://github.com/project-zot/zot/blob/main/examples/README.md#network).
+**Note:** For settings up a registry with TLS follow [these steps](https://github.com/project-zot/zot/blob/main/examples/README.md#network).
+
+## Phase 4: Clean up
+
+Stop and remove the running quick start registry and the uploaded content. 
+
+```
+docker rm $(docker stop oras-quickstart)
+```
 
-### Conclusion
+## Conclusion
 
 You can now successfully push OCI artifacts to your zot registry! 
 
-As OCI registries are used to securely store and share container images, they greatly help with collaboration and code sharing. They enable teams to acquire and use images through a standardized artifact interface. This is why it is considered to play a crucial role in maintaining consistency among teams.
+As OCI registries are used to securely store and share container images, they greatly help with collaboration and code sharing. They enable teams to acquire and use images and artifacts through a standardized artifact interface. This is why it is considered to play a crucial role in maintaining consistency among teams.

src/components/Header/index.jsx

@@ -10,7 +10,7 @@ export default function Header() {
                 <h1>ORAS</h1>
                 <h3>Distribute Artifacts Across OCI Registries With Ease</h3>
                 <div className={styles.header_content_input}>
-                    <Link to="/docs/installation" className='button button--secondary button--lg'>Get Started</Link>
+                    <Link to="/docs/quickstart" className='button button--secondary button--lg'>Get Started</Link>
                 </div>
             </div>
             <div className={styles.header_image}>