From 18430f296eebecf865355cb4a44128c4637cdeb5 Mon Sep 17 00:00:00 2001
From: Akshay Nair <phenax5@gmail.com>
Date: Mon, 5 Oct 2020 13:29:03 +0530
Subject: [PATCH] Update API.md

---
 API.md | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/API.md b/API.md
index 50659cdbd..128459c65 100644
--- a/API.md
+++ b/API.md
@@ -1,4 +1,4 @@
-# API Reference
+# Documentation
 
 ## How to register
 * First you need to create a pull request with your `domains/my-domain.json` file
@@ -27,6 +27,8 @@ Example (for github pages) -
 The way you register your own domain name is through a pull request.
 To register `my-domain.is-a.dev`, you need to create a `domains/my-domain.json` file
 
+The file needs to have the following fields -
+
 ### owner (required)
 You need to specify some information about yourself here.
 This is so that you can be contacted if required.
@@ -49,12 +51,14 @@ Describe your domain name and your usage. This is purely for documentation purpo
 This is a link to your website repository or your github account. This is purely for documentation purpose and is optional.
 
 
-### records
+### records (required)
 This is where you specify how you want to link to your server/webpage.
 
 Currently, only `CNAME`, `ALIAS`, `A`, `URL` record types are supported.
 
-##### CNAME/ALIAS
+Here's a few different use cases for the given record types -
+
+* **CNAME/ALIAS**
 Replace CNAME with ALIAS for alias record type
 ```json
 {
@@ -64,7 +68,7 @@ Replace CNAME with ALIAS for alias record type
 }
 ```
 
-##### A record
+* **A record**
 ```json
 {
   "records": {
@@ -78,7 +82,7 @@ Replace CNAME with ALIAS for alias record type
 }
 ```
 
-##### URL redirection
+* **URL redirection**
 ```json
 {
   "records": {
@@ -87,7 +91,7 @@ Replace CNAME with ALIAS for alias record type
 }
 ```
 
-##### Force HTTPS on your CNAME (or ALIAS or A) record
+* **Force HTTPS on your CNAME (or ALIAS or A) record**
 ```json
 {
   "records": {