From a08beceb5a74dacb5222ed0edc2376ed0856f3c0 Mon Sep 17 00:00:00 2001
From: Matthias Kretschmann <m@kretschmann.io>
Date: Wed, 15 Nov 2017 11:52:00 +0100
Subject: [PATCH] basic structure for guides section

---
 _config.yml                       |  3 +++
 _src/_data/menus.yml              | 10 ++++++----
 _src/_guides/hitchhikers-guide.md | 15 +++++++++++++++
 _src/guides.html                  | 16 ++++++++++++++++
 4 files changed, 40 insertions(+), 4 deletions(-)
 create mode 100644 _src/_guides/hitchhikers-guide.md
 create mode 100644 _src/guides.html

diff --git a/_config.yml b/_config.yml
index d58a8bf..08c00ab 100644
--- a/_config.yml
+++ b/_config.yml
@@ -90,6 +90,9 @@ collections:
     partners:
         output: true
         permalink: /:collection/:path/
+    guides:
+        output: true
+        permalink: /:collection/:path/
 
 
 # Plugins
diff --git a/_src/_data/menus.yml b/_src/_data/menus.yml
index 051ec0d..cc746a8 100644
--- a/_src/_data/menus.yml
+++ b/_src/_data/menus.yml
@@ -6,8 +6,8 @@ main:
       url: "/features/"
     - title: Use Cases
       url: "/usecases/"
-    - title: Enterprise
-      url: "/enterprise/"
+    - title: Guides
+      url: "/guides/"
     - title: Docs
       url: https://docs.bigchaindb.com/
 
@@ -16,10 +16,12 @@ secondary:
       url: "/faq/"
     - title: About
       url: "/about/"
-    - title: Whitepaper
-      url: "/whitepaper/"
     - title: Blog
       url: https://blog.bigchaindb.com
+    - title: Enterprise
+      url: "/enterprise/"
+    - title: Whitepaper
+      url: "/whitepaper/"
     - title: Contact
       url: "/contact/"
 
diff --git a/_src/_guides/hitchhikers-guide.md b/_src/_guides/hitchhikers-guide.md
new file mode 100644
index 0000000..369fca8
--- /dev/null
+++ b/_src/_guides/hitchhikers-guide.md
@@ -0,0 +1,15 @@
+---
+layout: page
+
+title: The Hitchhiker's Guide to BigchainDB & IPDB
+---
+
+If you’ve ever worked with databases or APIs, you’re likely familiar with CRUD. CRUD is short for Create, Read, Update, Delete. These are the basic operations of a persistent data store. So then, what’s ORM? ORM is an abstraction layer where database items are represented as programming language objects with variables as data, relations between items and functions that represent operations on that specific item in database. Django’s ORM is among the most famous ones:
+
+```
+>>> Post.objects.create(author=me, title='Sample title', text='Test')
+>>> Post.objects.all()
+<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>
+```
+
+Now, blockchains alter this interface. They allow Create, as in creating an asset or minting a token. They allow Read, as in querying for a transaction using it’s ID. They don’t allow to Update or Delete anything that has been written though.
diff --git a/_src/guides.html b/_src/guides.html
new file mode 100644
index 0000000..169a8a9
--- /dev/null
+++ b/_src/guides.html
@@ -0,0 +1,16 @@
+---
+layout: page
+
+title: Guides
+tagline: Get up to speed with BigchainDB & IPDB
+---
+
+{% for guide in site.guides %}
+
+<section class="section section--guide">
+    <div class="row">
+        <a href="{{ guide.url }}">{{ guide.title }}</a>
+    </div>
+</section>
+
+{% endfor %}