Consolidate Basic Concepts into 1-2 page overview

ipfs · Jan 31, 2023 · 6c16dda · 6c16dda
1 parent 9b97f17
commit 6c16dda
Show file tree

Hide file tree

Showing 4 changed files with 61 additions and 72 deletions.
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
@@ -105,21 +105,7 @@ module.exports = {
             },
           ],
           '/concepts/': [
-            {
-              title: 'Basic Concepts',
-              sidebarDepth: 1,
-              collapsable: true,
-              children: [
-                  '/concepts/what-is-ipfs',
-                  '/concepts/how-ipfs-works',
-                  '/concepts/content-addressing',
-                  '/concepts/hashing',
-                  '/concepts/immutability',
-                  '/concepts/persistence', 
-                  '/concepts/privacy-and-encryption',
-                  '/concepts/nodes'
-              ]
-            },
+            '/concepts/basic-concepts',
             {
               title: 'Subsystems and Components',
               sidebarDepth: 1,

diff --git a/docs/.vuepress/redirects b/docs/.vuepress/redirects
@@ -1,6 +1,7 @@
 /basics/ /install/
 /basics/desktop-app /how-to/desktop-app
 /basics/go/command-line-quick-start /how-to/command-line-quick-start
+/basics/concepts /concepts/basic-concepts
 /basics/js/js-ipfs /install/js-ipfs
 /basics/ipfs-implementations /concepts/ipfs-implementations
 /community/contribute/ /project/contribute

diff --git a/docs/basics/concepts.md b/docs/basics/concepts.md
diff --git a/docs/concepts/basic-concepts.md b/docs/concepts/basic-concepts.md
@@ -0,0 +1,59 @@
+---
+title: "Basic Concepts"
+description: "Lorem ipsum."
+draft: true
+---
+
+# What is IPFS?
+
+<!-- 
+Define IPFS in no more than a few paragrpahs
+Mention concepts listed below in relation to definition
+ -->
+
+## Multi-implementation
+
+Because IPFS is an [open-source](#open-source) protocol, it has multiple _implementations_. An implementation is software that implements the [technical specifications for IPFS](https://github.com/ipfs/specs).
+
+## Peer-to-peer
+
+<!-- 
+para 
+
+what is peer-to-peer
+how is ipfs peer-to-peer
+
+ -->
+
+## Content Addressing
+
+<!-- 
+1-2 para 
+
+location addressing (one or two sentences)
+what is content addressing + advantages over location addressing (a few sentences)
+how is ipfs using
+
+ -->
+
+## Hashing 
+
+<!-- 
+1-2 para 
+
+location addressing (one or two sentences)
+what is content addressing + advantages over location addressing (a few sentences)
+how is ipfs using
+
+ -->
+
+## Persistence 
+
+## Privacy and Security 
+
+## Decentralization 
+
+## Open source
+
+
+