Merge pull request #693 from dgraph-io/raphael/runnable

Raphael/runnable

Author: raphael-istari

.gitignore

@@ -3,3 +3,5 @@
 .DS_Store
 *.lock
 static/images/.DS_Store
+tmp/.htmltest/htmltest.log
+tmp/.htmltest/refcache.json

.htmltest.yml

@@ -0,0 +1,18 @@
+DirectoryPath: "public"
+CheckDoctype: true
+CheckExternal: true
+CheckInternalHash: true
+IgnoreDirectoryMissingTrailingSlash: true
+IgnoreAltMissing: true
+IgnoreEmptyHref: true
+IgnoreInternalEmptyHash: true
+IgnoreURLs:
+  - "https://fonts.googleapis.com"
+  - "https://cdnjs.cloudflare.com"
+  - "https://www.npmjs.com/package/@grpc/grpc-js"
+  - "https://www.npmjs.com/package/apollo-client"
+  - "http://localhost:*"
+  - "/livereload.js"
+  - ".*livereload.*"
+  - "^#$"
+ExternalTimeout: 15

content/deploy/_index.md

@@ -8,16 +8,8 @@ aliases = ["/deploy/overview"]
   identifier = "deploy"
 +++
 
-You can deploy and manage Dgraph database in a variety of self-managed deployment scenarios, including:
+You can deploy and manage Dgraph database in a variety of self-managed deployment scenarios.
 
-* Running Dgraph on your on-premises infrastructure (bare-metal physical servers)
-* Running Dgraph on your cloud infrastructure (AWS, GCP and Azure)
-
-This section focuses exclusively on deployment and management for these self-managed
-scenarios. To learn about fully-managed options that let you focus on
-building apps and websites, rather than managing infrastructure, see the 
-[Dgraph cloud services docs](https://dgraph.io/docs/cloud/), or 
-[Try Dgraph Cloud](https://cloud.dgraph.io/).
 
 A Dgraph cluster consists of the following:
 

content/deploy/admin/dgraph-administration.md

@@ -201,11 +201,11 @@ When the new cluster (that uses the upgraded version of Dgraph) is up and runnin
 ### Upgrade from v1.2.2 to v20.03.0 for Enterprise customers
 
 <!-- TODO: Redirect(s) -->
-1. Use [binary backup]({{< relref "enterprise-features/binary-backups.md">}}) to export data from old cluster
+1. Use [binary backup]({{< relref "binary-backups.md">}}) to export data from old cluster
 2. Ensure it is successful
 3. [Shutdown Dgraph]({{< relref "#shut-down-database" >}}) and wait for all writes to complete
 4. Upgrade `dgraph` binary to `v20.03.0`
-5. [Restore]({{< relref "enterprise-features/binary-backups.md#restore-from-backup">}}) from the backups using upgraded `dgraph` binary
+5. Restore from the backups using upgraded `dgraph` binary
 6. Start a new Dgraph cluster using the restored data directories
 7. Upgrade ACL data using the following command:
 
@@ -219,7 +219,7 @@ dgraph upgrade --acl -a localhost:9080 -u groot -p password
 2. Ensure it is successful
 3. [Shutdown Dgraph]({{< relref "#shut-down-database" >}}) and wait for all writes to complete
 4. Upgrade `dgraph` binary to `v20.07.0`
-5. [Restore]({{< relref "enterprise-features/binary-backups.md#restore-from-backup">}}) from the backups using upgraded `dgraph` binary
+5. Restore from the backups using upgraded `dgraph` binary
 6. Start a new Dgraph cluster using the restored data directories
 7. Upgrade ACL data using the following command:
     ```sh
@@ -244,7 +244,7 @@ are affected. Then, you can drop the old types and predicates from DB.
 2. Ensure it is successful
 3. [Shutdown Dgraph]({{< relref "#shut-down-database" >}}) and wait for all writes to complete
 4. Upgrade `dgraph` binary to `v21.03.0`
-5. [Restore]({{< relref "enterprise-features/binary-backups.md#restore-from-backup">}}) from the backups using the upgraded `dgraph` binary
+5. Restore from the backups using the upgraded `dgraph` binary
 6. Start a new Dgraph cluster using the restored data directories
 7. Upgrade the CORS and persisted queries. To upgrade an ACL cluster use:
     ```sh
@@ -268,4 +268,4 @@ as backup and restore are cluster-wide operations and a single namespace cannot
 
 ## Post Installation
 
-Now that Dgraph is up and running, to understand how to add and query data to Dgraph, follow [Query Language Spec](/query-language). Also, have a look at [Frequently asked questions](/faq).
+Now that Dgraph is up and running, to understand how to add and query data to Dgraph, follow [Query Language Spec](/query-language). 

content/deploy/admin/dgraph-alpha.md

@@ -92,7 +92,7 @@ query {
 - **`group`**: Group assigned based on the replication factor.
 - **`lastEcho`**: Last time, in Unix epoch, when the instance was contacted by another Alpha or Zero server.
 - **`ongoing`**: List of ongoing operations in the background.
-- **`indexing`**: List of predicates for which indexes are built in the background. Read more [here]({{< relref "/dql/dql-schema.md#indexes-in-background" >}}).
+- **`indexing`**: List of predicates for which indexes are built in the background.
 
 {{% notice "note" %}}
 The same information (except `ongoing` and `indexing`) is available from the `/health` and `/health?all` HTTP endpoints.

content/deploy/admin/tracing.md

@@ -32,16 +32,16 @@ You can run multiple Jaeger collector components for the same single Jaeger back
 
 Once you have this configured, you can filter by tags in the Jaeger UI. Filter traces by tags matching `env=dev`:
 
-{{% load-img "/images/jaeger-ui.png" "Jaeger UI" %}}
+{{% load-img "images/jaeger-ui.png" "Jaeger UI" %}}
 
 Every trace has your custom tags set under the “Process” section of each span:
 
-{{% load-img "/images/jaeger-server-query.png" "Jaeger Query" %}}
+{{% load-img "images/jaeger-server-query.png" "Jaeger Query" %}}
 
 Filter traces by tags matching `env=qa`:
 
-{{% load-img "/images/jaeger-json.png" "Jaeger JSON" %}}
+{{% load-img "images/jaeger-json.png" "Jaeger JSON" %}}
 
-{{% load-img "/images/jaeger-server-query-2.png" "Jaeger Query Result" %}}
+{{% load-img "images/jaeger-server-query-2.png" "Jaeger Query Result" %}}
 
 To learn more about Jaeger, see [Jaeger's Deployment Guide](https://www.jaegertracing.io/docs/deployment/).

content/deploy/installation/single-host-setup.md

@@ -63,7 +63,7 @@ The command should return basic cluster information:
 ```
 
 ### Connect Ratel
-Ratel is a web-based UI dashboard for interacting with Dgraph using Dgraph's query language,[DQL](./glossary#DQL).
+Ratel is a web-based UI dashboard for interacting with Dgraph using Dgraph's query language, [DQL]({{<relref "/dgraph-glossary#DQ">}}).
 
 Optionnaly, launch Ratel using the dgraph/ratel docker image :
 

content/dgraph-glossary.md

@@ -67,7 +67,7 @@ A relationship is  a named, directed link relating one [node](#node) to another.
 Sharding is a database architecture pattern to achieve horizontal scale by distributing data among many servers. Dgraph shards data per relationship, so all data for one relationship form a single shard, and are stored on one (group of) servers, an approach referred to as 'predicate-based sharding'.
 
 ### Triple ###
-Because RDF statements consist of three elements: <subject> <predicate> <object>, they are called triples. A triple represents a single atomic statement about a node. The object in an RDF triple can be a literal value or can point to another node. See [DQL RDF Syntax]("/dql/dql-syntax/dql-rdf") for more details.
+Because RDF statements consist of three elements: <subject> <predicate> <object>, they are called triples. A triple represents a single atomic statement about a node. The object in an RDF triple can be a literal value or can point to another node. See [DQL RDF Syntax](/dql/dql-syntax/dql-rdf) for more details.
 - when we store that a node name is "Alice". The predicate is ``name`` and predicate value is the string "Alice". The string becomes a node property.
 - when we store that Alice knows Bob, we may use a predicate ``knows`` with the node representing Alice. The value of this predicate would be the [uid](#uid) of the node representing Bob. In that case, ``knows`` is a [relationship](#relationship).
 

content/dgraph-overview.md

@@ -52,7 +52,7 @@ Dgraph is built from the ground up as a distributed system. Data is automaticall
 
 Each Dgraph cluster consists of multiple server groups (shards) that work together to store and query your data. Queries are automatically distributed across the relevant shards and results are aggregated, making the distributed nature transparent to your application. This architecture provides both horizontal scalability and high availability.
 
-For detailed information about Dgraph's distributed architecture, clustering, and replication, see the [Architecture documentation]("/deploy/archiveture").
+For detailed information about Dgraph's distributed architecture, clustering, and replication, see the [Architecture documentation](/deploy/dgraph-architecture).
 
 ## Enterprise-Grade Features
 
@@ -120,7 +120,7 @@ The graph model naturally represents connected data, making it straightforward t
 ## What's Next
 
 - Get familiar with some terms in our [Glossary](/dgraph-glossary)
-- Go through some [tutorials]("/learn")
+- Go through some [tutorials]({{<relref "learn">}})
 
 
 

content/dql/clients/csharp.md

@@ -50,13 +50,7 @@ client.Login(lr)
 In the example above, the client logs into namespace `123` using username `userId` and password `password`.
 Once logged in, the client can perform all the operations allowed to the `userId` user of namespace `123`.
 
-### Creating a Client for Dgraph Cloud Endpoint
 
-If you want to connect to Dgraph running on your [Dgraph Cloud](https://cloud.dgraph.io) instance, then all you need is the URL of your Dgraph Cloud endpoint and the API key. You can get a client using them as follows:
-
-```c#
-var client = new DgraphClient(SlashChannel.Create("https://frozen-mango.eu-central-1.aws.cloud.dgraph.io/graphql", "api-key-here"));
-```
 
 ### Altering the Database