Fixed markdown linting errors and links (#71)

Signed-off-by: Sajay Antony <[email protected]>

Author: sajayantony

README.md

@@ -1,40 +1,45 @@
 # Ratify
 
 The project provides a framework to integrate scenarios that require
-verification of references and aim to provide a set of interfaces that can
-be consumed by various systems that can participate in artifact verification.
+verification of reference artifacts and provides a set of interfaces
+that can be consumed by various systems that can participate in
+artifact ratification.
 
 **WARNING:** This is experimental code. It is not considered production-grade
 by its developers, nor is it "supported" software.
 
 ## Table of Contents
-- [Ratify Quick Start](#ratify-quick-start)
+
+- [Quick Start](#quick-start)
 - [Documents](#documents)
 - [Code of Conduct](#code-of-conduct)
 - [Release Management](#release-management)
 - [Licensing](#licensing)
 - [Trademark](#trademark)
 
-## Ratify Quick Start
+## Quick Start
 
-### Setup 
+### Setup
 
-- Build the ```ratify``` binary
+- Build the `ratify` binary
 
 ```bash
 git clone https://github.com/deislabs/ratify.git
 go build -o ~/bin ./cmd/ratify
 ```
 
-- Build the ```ratify``` plugins and install them in the home directory
+- Build the `ratify` plugins and install them in the home directory
 
 ```bash
 go build -o ~/.ratify/plugins/ ./plugins/verifier/sbom
 ```
 
-- ```ratify``` is ready to use
+- `ratify` is ready to use
 
 ```bash
+$ ratify --help
+Ratify is a reference artifact tool for managing and verifying reference artifacts
+
 Usage:
   ratify [flags]
   ratify [command]
@@ -54,15 +59,18 @@ Use "ratify [command] --help" for more information about a command.
 ```
 
 ### Verify a Graph of Supply Chain Content
-To get started with ```Ratify```, the basic steps involve
+
+To get started with `ratify`, follow the step below.
+
 - Create a graph of Supply Chain Content
-- Discover the graph using ```ratify```
-- Verify the graph using ```ratify```
+- Discover the graph using `ratify`
+- Verify the graph using `ratify`
 
-This section outlines instructions for each of the above steps. 
+This section outlines instructions for each of the above steps.
 
 #### **Create a graph of Supply Chain Content**
-A graph of supply chain content can be created with different tools that can manage individual supply chain objects within the graph. For this quick start, the steps outlined in [Notary V2 project] (https://deploy-preview-48--notarydev.netlify.app/blog/2021/announcing-notation-alpha1/) will be used to create a sample graph with [```notation```](https://github.com/notaryproject/notation) and [```oras```](https://github.com/oras-project/oras/releases/tag/v0.2.1-alpha.1) CLI.
+
+A graph of supply chain content can be created with different tools that can manage individual supply chain objects within the graph. For this quick start, the steps outlined in [Notary V2 project] (https://notaryproject.dev/blog/2021/announcing-notation-alpha1/) will be used to create a sample graph with [`notation`](https://github.com/notaryproject/notation) and [`ORAS`](https://github.com/oras-project/oras/releases/tag/v0.2.1-alpha.1) CLI.
 
 - Run a local instance of the [CNCF Distribution Registry](https://github.com/oras-project/distribution), with [ORAS Artifacts](https://github.com/oras-project/artifacts-spec/blob/main/artifact-manifest.md) support.
 
@@ -73,22 +81,25 @@ export REPO=net-monitor
 export IMAGE=${REGISTRY}/${REPO}:v1
 
 docker run -d -p ${PORT}:5000 ghcr.io/oras-project/registry:v0.0.3-alpha
-``` 
+```
+
 - Build & Push an image
 
 ```bash
 docker build -t $IMAGE https://github.com/wabbit-networks/net-monitor.git#main
 
 docker push $IMAGE
 ```
-- Sign the image and push the signature using ```notation```
+
+- Sign the image and push the signature using `notation`
 
 registry.
 
 ```bash
 notation cert generate-test --default "wabbit-networks.io"
 notation sign --plain-http $IMAGE
 ```
+
 - Generate a sample SBoM and push to registry
 
 ```bash
@@ -103,7 +114,7 @@ oras push ${REGISTRY}/${REPO} \
   sbom.json:application/json
 ```
 
-- Sign the SBoM and push the signature using ```notation```
+- Sign the SBoM and push the signature using `notation`
 
 ```bash
 # Capture the digest of the SBOM, to sign it
@@ -113,6 +124,7 @@ SBOM_DIGEST=$(oras discover -o json \
 
 notation sign --plain-http $REGISTRY/$REPO@$SBOM_DIGEST
 ```
+
 This completes the creation of the supply chain graph.
 
 #### **Create config with signature and SBoM verifiers**
@@ -156,16 +168,18 @@ cat <<EOF > ~/.ratify/config.json
 }
 EOF
 ```
-#### Discover the graph 
 
-> Please make sure that the subject is referenced with ```digest``` rather
+#### Discover the graph
+
+> Please make sure that the subject is referenced with `digest` rather
 than with the tag.
+
 ```bash
 export IMAGE_DIGEST_REF=$(docker image inspect $IMAGE | jq -r '.[0].RepoDigests[0]')
 
 # Discover the graph
 ratify discover -s $IMAGE_DIGEST_REF
-``` 
+```
 
 #### Verify the graph
 
@@ -189,8 +203,8 @@ FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact
 [[email protected]](mailto:[email protected]) with any additional
 questions or comments.
 
-
 ## Release Management
+
 The Ratify release process is defined in [RELEASES.md](./RELEASES.md).
 
 ## Licensing