update quick start to use RDF

better quick start.
Move the json mutation example to Json format page.

Author: raphael-istari

README.md

@@ -67,6 +67,27 @@ Now you can make changes to the docs and see them being updated instantly, thank
 
 **Note**: While running locally, the version selector does not work because you need to build the documentation and serve it behind a reverse proxy to have multiple versions. Also, formatting of lists is less fussy when running locally; so please precede lists with a blank line in your PR.
 
+### Testing for broken links
+
+We use [htmltest](https://github.com/wjdp/htmltest) to check for broken links in the generated documentation. To test for broken links after building the site:
+
+1. Build the Hugo site:
+   ```bash
+   hugo --destination=public --baseURL=http://example.com
+   ```
+
+2. Run htmltest:
+   ```bash
+   htmltest
+   ```
+
+   Or combine both steps:
+   ```bash
+   hugo --destination=public --baseURL=http://example.com && htmltest  2>&1
+   ```
+
+The htmltest configuration is in `.htmltest.yml` at the root of the repository. It automatically ignores development-only files like `livereload.js` and empty hash links used for JavaScript interactions.
+
 ### Running docs locally with Docker
 
 Make sure you have docker-compose installed.

content/dql/dql-get-started.md

@@ -10,9 +10,49 @@ weight = 2
 Dgraph supports [Mutations]({{< relref "dql-mutation.md" >}}) in JSON or [RDF]({{< relref "dql-rdf.md" >}}) format.
 When using JSON format Dgraph creates nodes and relationships from the JSON structure and assigns UIDs to nodes.
 
+## Quick Start Example
+
+If you followed the [Quick Start guide]({{< relref "../quick-start.md" >}}), you added data to your graph using RDF format. The same data can also be added using JSON format. Here's an example of how to create the movie data from the quick start using JSON:
+
+```dql
+{
+  "set": [
+    {
+      "name": "Star Wars: Episode IV - A New Hope",
+      "release_date": "1977-05-25",
+      "director": {
+        "name": "George Lucas",
+        "dgraph.type": "Person"
+      },
+      "starring": [
+        {
+          "name": "Luke Skywalker"
+        },
+        {
+          "name": "Princess Leia"
+        },
+        {
+          "name": "Han Solo"
+        }
+      ]
+    },
+    {
+      "name": "Star Trek: The Motion Picture",
+      "release_date": "1979-12-07"
+    }
+  ]
+}
+```
+
+The sample JSON data is an array of two movies with some attributes. These are stored as [nodes]({{< relref "../dgraph-glossary.md#node" >}}) in Dgraph.
+
+The "Star Wars" movie has a `director` field which is a JSON object and a `starring` field which is an array of JSON objects. Each object is also stored as a node in Dgraph. The `director` and `starring` are stored as [relationships]({{< relref "../dgraph-glossary.md#relationship" >}}).
+
 ## Specifying node UIDs
 
-For example, if you run this mutation:
+When you create nodes using JSON mutations, Dgraph automatically assigns a [UID]({{< relref "../dgraph-glossary.md#uid" >}}) to each new node. Dgraph also generates an internal identifier during the transaction, which is then converted to the final UID.
+
+For example, this mutation creates a single node:
 
 ```dql
  {
@@ -24,7 +64,8 @@ For example, if you run this mutation:
    ]
  }  
 ```
-You will see that Dgraph responds with
+
+Dgraph responds with:
 {{< highlight json "linenos=false,hl_lines=7 " >}}
 {
   "data": {

content/dql/json-mutation-format.md

@@ -15,7 +15,7 @@ weight = 3
 ### Recommended learning path
 - See [Dgraph Overview]({{< relref "dgraph-overview.md" >}}) for an introduction to Dgraph database and a presentation of Dgraph cluster architecture.
 - Get familiar with some terms in the [Glossary]({{< relref "dgraph-glossary.md" >}}).
-- Follow the [Dgraph Query Language(DQL)  Quickstart]({{< relref "dql/dql-get-started" >}}) to execute some queries.
+- Follow the [Dgraph Query Language(DQL)  Quickstart]({{< relref "quick-start" >}}) to execute some queries.
 - Follow the [Get Started with Dgraph]({{< relref "learn/data-engineer/get-started-with-dgraph" >}}) tutorial.
 - Use [DQL Syntax]({{< relref "dql-query.md">}}) and [Query Language]({{< relref "_index.md" >}}) as references.
 - Go to [Clients]({{< relref "clients" >}}) to see how to communicate