ipfs · cwaring · Dec 10, 2019 · Dec 4, 2019 · Dec 4, 2019 · Dec 4, 2019
diff --git a/docs/.vuepress/theme/components/LegacyCallout.vue b/docs/.vuepress/theme/components/LegacyCallout.vue
@@ -0,0 +1,44 @@
+<template>
+  <div class="tip custom-block legacy-callout">
+    <p>
+      This site is in beta.
+      <a
+        href="https://github.com/ipfs/docs/issues/new?assignees=&labels=OKR+3%3A+Content+Improvement%2C+docs-ipfs&template=documentation-issue.md&title=%5BDOCS+ISSUE%5D+Beta+Site+Feedback"
+        target="_blank"
+        >Submit feedback</a
+      >
+      <span v-if="$site.themeConfig.betaTestFormUrl">
+        or
+        <a :href="$site.themeConfig.betaTestFormUrl" target="_blank"
+          >become a tester</a
+        >
+      </span>
+      to help us improve it!
+      <span v-if="legacyUrl" class="content-status-status">
+        <br />
+        <a target="_blank" :href="legacyUrl">View this page on legacy site</a>
+      </span>
+    </p>
+  </div>
+</template>
+
+<script>
+export default {
+  computed: {
+    legacyUrl: function() {
+      return this.$frontmatter && this.$frontmatter.legacyUrl
+    }
+  }
+}
+</script>
+
+<style lang="stylus" scoped>
+.legacy-callout {
+  background-color: #f6f9fa;
+  color: #737681;
+  border-color: #5db5be;
+}
+
+@media (min-width: $MQNarrow) {
+}
+</style>
diff --git a/docs/.vuepress/theme/global-components/LegacyCallout.vue b/docs/.vuepress/theme/global-components/LegacyCallout.vue
@@ -0,0 +1,65 @@
+<template>
+  <main class="content-status">
+    <div>
+      <div class="tip custom-block legacy-callout">
+        <p>
+          <b>
+            This site is in beta. Help us improve it!
+          </b>
+        </p>
+        <p>
+          <a
+            href="https://github.com/ipfs/docs/issues/new?assignees=&labels=OKR+3%3A+Content+Improvement%2C+docs-ipfs&template=content-request.md&title=%5BCONTENT+REQUEST%5D+%28add+your+title+here%21%29"
+            target="_blank"
+          >
+            Suggest new content
+          </a>
+          <br />
+          <a href="https://ipfs.canny.io/docs-features" target="_blank">
+            Request features
+          </a>
+          <br />
+          <a
+            href="https://github.com/ipfs/docs/issues/new?assignees=&labels=OKR+3%3A+Content+Improvement%2C+docs-ipfs&template=documentation-issue.md&title=%5BDOCS+ISSUE%5D+%28add+your+title+here%21%29"
+            target="_blank"
+          >
+            Give general feedback
+          </a>
+          <br />
+          <span v-if="$site.themeConfig.betaTestFormUrl">
+            <a :href="$site.themeConfig.betaTestFormUrl" target="_blank">
+              Become a tester
+            </a>
+          </span>
+          <br />
+          <span v-if="legacyUrl" class="content-status-status">
+            <br />
+            <a target="_blank" :href="legacyUrl"
+              >View this page on legacy site</a
+            >
+          </span>
+        </p>
+      </div>
+    </div>
+  </main>
+</template>
+
+<script>
+export default {
+  computed: {
+    legacyUrl: function() {
+      return this.$frontmatter && this.$frontmatter.legacyUrl
+    }
+  }
+}
+</script>
+
+<style lang="stylus" scoped>
+.legacy-callout {
+  background-color:#f6f9fa;
+  color: #737681;
+  border-color: #5db5be;
+}
+@media (min-width: $MQNarrow) {
+}
+</style>
diff --git a/docs/README.md b/docs/README.md
@@ -1,5 +1,6 @@
 ---
 title: IPFS Documentation
+legacyUrl: https://docs.ipfs.io/
 ---
 
 # IPFS Documentation

diff --git a/docs/community/README.md b/docs/community/README.md
@@ -1,5 +1,6 @@
 ---
 title: Community
+legacyUrl: https://docs.ipfs.io/community/
 ---
 
 # Community

diff --git a/docs/community/irc.md b/docs/community/irc.md
@@ -1,5 +1,6 @@
 ---
 title: IRC
+legacyUrl: https://docs.ipfs.io/community/irc/
 ---
 
 # Internet Relay Chat (IRC)

diff --git a/docs/community/social-media.md b/docs/community/social-media.md
@@ -1,6 +1,7 @@
 ---
 title: Social media
 sidebarDepth: 0
+legacyUrl: https://docs.ipfs.io/community/
 ---
 
 # Social media

diff --git a/docs/concepts/README.md b/docs/concepts/README.md
@@ -1,5 +1,6 @@
 ---
 title: Concepts
+legacyUrl: https://docs.ipfs.io/guides/concepts/
 ---
 
 # IPFS concepts

diff --git a/docs/concepts/content-addressing.md b/docs/concepts/content-addressing.md
@@ -1,5 +1,6 @@
 ---
 title: Content addressing
+legacyUrl: https://docs.ipfs.io/guides/concepts/cid/
 ---
 
 # Content addressing and CIDs

diff --git a/docs/concepts/dht.md b/docs/concepts/dht.md
@@ -1,5 +1,6 @@
 ---
 title: Distributed Hash Tables (DHTs)
+legacyUrl: https://docs.ipfs.io/guides/concepts/dht/
 ---
 
 # Distributed Hash Tables (DHTs)

diff --git a/docs/concepts/dnslink.md b/docs/concepts/dnslink.md
@@ -1,5 +1,6 @@
 ---
 title: DNSLink
+legacyUrl: https://docs.ipfs.io/guides/concepts/dnslink/
 ---
 
 # DNSLink

diff --git a/docs/concepts/faq.md b/docs/concepts/faq.md
@@ -1,5 +1,6 @@
 ---
 title: FAQ
+legacyUrl: https://docs.ipfs.io/introduction/faq/
 ---
 
 # Frequently asked questions

diff --git a/docs/concepts/file-systems.md b/docs/concepts/file-systems.md
@@ -1,5 +1,6 @@
 ---
 title: File systems
+legacyUrl: https://docs.ipfs.io/guides/concepts/mfs/
 ---
 
 # File systems and IPFS

diff --git a/docs/concepts/hashing.md b/docs/concepts/hashing.md
@@ -1,5 +1,6 @@
 ---
 title: Hashing
+legacyUrl: https://docs.ipfs.io/guides/concepts/hashes/
 ---
 
 # Hashing

diff --git a/docs/concepts/how-ipfs-works.md b/docs/concepts/how-ipfs-works.md
@@ -1,5 +1,6 @@
 ---
 title: How IPFS works
+legacyUrl: https://docs.ipfs.io/introduction/how-ipfs-works/
 ---
 
 # How IPFS works

diff --git a/docs/concepts/ipns.md b/docs/concepts/ipns.md
@@ -1,5 +1,6 @@
 ---
 title: IPNS
+legacyUrl: https://docs.ipfs.io/guides/concepts/ipns/
 ---
 
 # InterPlanetary Name System (IPNS)

diff --git a/docs/concepts/merkle-dag.md b/docs/concepts/merkle-dag.md
@@ -1,5 +1,6 @@
 ---
 title: Merkle DAGs
+legacyUrl: https://docs.ipfs.io/guides/concepts/merkle-dag/
 ---
 
 # Merkle Distributed Acyclic Graphs (DAGs)

diff --git a/docs/concepts/persistence.md b/docs/concepts/persistence.md
@@ -1,5 +1,6 @@
 ---
 title: Persistence
+legacyUrl: https://docs.ipfs.io/guides/concepts/pinning/
 ---
 
 # Persistence, permanence and pinning

diff --git a/docs/concepts/what-is-ipfs.md b/docs/concepts/what-is-ipfs.md
@@ -1,7 +1,10 @@
 ---
 title: What is IPFS?
+legacyUrl: https://docs.ipfs.io/introduction/overview/
 ---
 
+# What is IPFS?
+
 Let's just start with a one-line definition of IPFS:
 
 **IPFS is a distributed system for storing and accessing files, websites, applications, and data.**

diff --git a/docs/how-to/README.md b/docs/how-to/README.md
@@ -1,5 +1,6 @@
 ---
 title: How-tos
+legacyUrl: https://docs.ipfs.io/guides/examples/
 ---
 
 # IPFS how-tos and tutorials

diff --git a/docs/how-to/address-ipfs-on-web.md b/docs/how-to/address-ipfs-on-web.md
@@ -1,5 +1,6 @@
 ---
 title: Address IPFS on the Web
+legacyUrl: https://docs.ipfs.io/guides/guides/addressing/
 ---
 
 # Address IPFS on the Web

diff --git a/docs/how-to/command-line-quick-start.md b/docs/how-to/command-line-quick-start.md
@@ -1,5 +1,6 @@
 ---
 title: Command-line quick start
+legacyUrl: https://docs.ipfs.io/introduction/usage/
 ---
 
 # Command-line quick start

diff --git a/docs/how-to/configure-node.md b/docs/how-to/configure-node.md
@@ -1,5 +1,6 @@
 ---
 title: Configure a node
+legacyUrl: https://docs.ipfs.io/guides/examples/config/
 ---
 
 # Configure a node

diff --git a/docs/how-to/host-git-style-repo.md b/docs/how-to/host-git-style-repo.md
@@ -1,5 +1,6 @@
 ---
 title: Host a Git-style repo
+legacyUrl: https://docs.ipfs.io/guides/examples/git/
 ---
 
 # Host a Git-style repo

diff --git a/docs/how-to/host-single-page-site.md b/docs/how-to/host-single-page-site.md
@@ -1,5 +1,6 @@
 ---
 title: Host a single-page site
+legacyUrl: https://docs.ipfs.io/guides/examples/websites/
 ---
 
 # Host a single-page website

diff --git a/docs/how-to/modify-bootstrap-list.md b/docs/how-to/modify-bootstrap-list.md
@@ -1,5 +1,6 @@
 ---
 title: Modify the bootstrap list
+legacyUrl: https://docs.ipfs.io/guides/examples/bootstrap/
 ---
 
 # Modify the bootstrap peers list

diff --git a/docs/how-to/observe-peers.md b/docs/how-to/observe-peers.md
@@ -1,5 +1,6 @@
 ---
 title: Observe peers
+legacyUrl: https://docs.ipfs.io/guides/examples/network/
 ---
 
 # Observe peers

diff --git a/docs/how-to/pin-files.md b/docs/how-to/pin-files.md
@@ -1,5 +1,6 @@
 ---
 title: Pin files
+legacyUrl: https://docs.ipfs.io/guides/examples/pinning/
 ---
 
 # Pin files using IPFS

diff --git a/docs/how-to/store-play-videos.md b/docs/how-to/store-play-videos.md
@@ -1,5 +1,6 @@
 ---
 title: Store & play videos
+legacyUrl: https://docs.ipfs.io/guides/examples/videos/
 ---
 
 # Store and play videos

diff --git a/docs/how-to/take-snapshot.md b/docs/how-to/take-snapshot.md
@@ -1,5 +1,6 @@
 ---
 title: Take a snapshot
+legacyUrl: https://docs.ipfs.io/guides/examples/snapshots/
 ---
 
 # Take a snapshot

diff --git a/docs/how-to/work-with-blocks.md b/docs/how-to/work-with-blocks.md
@@ -1,5 +1,6 @@
 ---
 title: Work with blocks
+legacyUrl: https://docs.ipfs.io/guides/examples/blocks/
 ---
 
 # Work with blocks

diff --git a/docs/install/README.md b/docs/install/README.md
@@ -1,6 +1,7 @@
 ---
 title: Install IPFS
 sidebarDepth: 0
+legacyUrl: https://docs.ipfs.io/introduction/usage/
 ---
 
 # Install IPFS

diff --git a/docs/project/contribute.md b/docs/project/contribute.md
@@ -1,5 +1,6 @@
 ---
 title: Contribute to IPFS
+legacyUrl: https://docs.ipfs.io/community/contribute/how-to-help/
 ---
 
 # Contribute to IPFS

diff --git a/docs/reference/README.md b/docs/reference/README.md
@@ -1,5 +1,6 @@
 ---
 title: API & CLI
+legacyUrl: https://docs.ipfs.io/reference/api/
 ---
 
 # API & CLI reference

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
@@ -1,5 +1,6 @@
 ---
 title: CLI commands
+legacyUrl: https://docs.ipfs.io/reference/api/cli/
 ---
 
 # Command-line interface (CLI) reference

diff --git a/docs/reference/go/api.md b/docs/reference/go/api.md
@@ -1,5 +1,6 @@
 ---
 title: go-ipfs API
+legacyUrl: https://docs.ipfs.io/reference/go/overview/
 ---
 
 # API resources for go-ipfs

diff --git a/docs/reference/http/api.md b/docs/reference/http/api.md
@@ -1,5 +1,6 @@
 ---
 title: HTTP API
+legacyUrl: https://docs.ipfs.io/reference/api/http/
 ---
 
 # HTTP API reference
@@ -88,12 +89,14 @@ flag is the `&encoding=json` query parameter below:
 ```
 
 ## HTTP status codes
+
 Status codes used at the RPC layer are simple:
-* `500` - RPC endpoint returned an error
-* `404` - RPC endpoint doesn't exist
-* `400` - Malformed RPC, argument type error, etc
-* `403` - RPC call forbidden
-In other words, `500` means that the function _does_ exist, it just failed internally for some reason. To know that reason, you have to look at the "application layer" error (commands lib error).
+
+- `500` - RPC endpoint returned an error
+- `404` - RPC endpoint doesn't exist
+- `400` - Malformed RPC, argument type error, etc
+- `403` - RPC call forbidden
+  In other words, `500` means that the function _does_ exist, it just failed internally for some reason. To know that reason, you have to look at the "application layer" error (commands lib error).
 
 ## HTTP commands
 
@@ -3626,5 +3629,3 @@ On success, the call to this endpoint will return with 200 and the following bod
 ### cURL Example
 
 `curl "http://localhost:5001/api/v0/version/deps"`
-
-
diff --git a/docs/reference/js/api.md b/docs/reference/js/api.md
@@ -1,5 +1,6 @@
 ---
 title: js-ipfs API
+legacyUrl: https://docs.ipfs.io/reference/js/
 ---
 
 # API resources for js-ipfs