From 48b03b4001b942fcb204bf12080fa2c839c853f7 Mon Sep 17 00:00:00 2001
From: Ines Montani <ines@ines.io>
Date: Fri, 23 Dec 2016 14:35:50 +0100
Subject: [PATCH] Fix formatting and wording

---
 website/docs/usage/resources.jade | 102 ++++++++++++++++++++++--------
 1 file changed, 76 insertions(+), 26 deletions(-)

diff --git a/website/docs/usage/resources.jade b/website/docs/usage/resources.jade
index e0f681e8e..b717e2d56 100644
--- a/website/docs/usage/resources.jade
+++ b/website/docs/usage/resources.jade
@@ -8,61 +8,111 @@ p Many of the associated tools and resources that we're developing alongside spa
 
 +table(["Name", "Description"])
     +row
-        +cell #[+src(gh("spacy-dev-resources")) spaCy Dev Resources]
-        +cell Scripts, tools and resources for developing spaCy, adding new languages and training new models.
+        +cell
+            +src(gh("spacy-dev-resources")) spaCy Dev Resources
+
+        +cell
+            |  Scripts, tools and resources for developing spaCy, adding new
+            |  languages and training new models.
 
     +row
-        +cell #[+src("spacy-benchmarks") spaCy Benchmarks]
-        +cell Runtime performance comparison of spaCy against other NLP libraries.
+        +cell
+            +src("spacy-benchmarks") spaCy Benchmarks
+
+        +cell
+            |  Runtime performance comparison of spaCy against other NLP
+            |  libraries.
 
     +row
-        +cell #[+src(gh("spacy-services")) spaCy Services]
-        +cell REST microservices for spaCy demos and visualisers.
+        +cell
+            +src(gh("spacy-services")) spaCy Services
+
+        +cell
+            |  REST microservices for spaCy demos and visualisers.
 
 +h(2, "libraries") Libraries and projects
 +table(["Name", "Description"])
     +row
-        +cell #[+src(gh("sense2vec")) sense2vec]
-        +cell Use spaCy to go beyond vanilla #[+a("https://en.wikipedia.org/wiki/Word2vec") Word2vec].
+        +cell
+            +src(gh("sense2vec")) sense2vec
+
+        +cell
+            |  Use spaCy to go beyond vanilla
+            |  #[+a("https://en.wikipedia.org/wiki/Word2vec") Word2vec].
 
 +h(2, "utility") Utility libraries and dependencies
 
 +table(["Name", "Description"])
     +row
-        +cell #[+src(gh("thinc")) thinc]
-        +cell Super sparse multi-class machine learning with Cython.
+        +cell
+            +src(gh("thinc")) thinc
+
+        +cell
+            |  Super sparse multi-class machine learning with Cython.
 
     +row
-        +cell #[+src(gh("sputnik")) sputnik]
-        +cell Data package manager library for spaCy.
+        +cell
+            +src(gh("sputnik")) sputnik
+
+        +cell
+            |  Data package manager library for spaCy.
 
     +row
-        +cell #[+src(gh("sputnik-server")) sputnik Server]
-        +cell Index service for the sputnik data package manager for spaCy.
+        +cell
+            +src(gh("sputnik-server")) sputnik Server
+
+        +cell
+            |  Index service for the sputnik data package manager for spaCy.
 
     +row
-        +cell #[+src(gh("cymem")) cymem]
-        +cell Gate Cython calls to malloc/free behind Python ref-counted objects.
+        +cell
+            +src(gh("cymem")) cymem
+
+        +cell
+            |  Gate Cython calls to malloc/free behind Python ref-counted
+            |  objects.
 
     +row
-        +cell #[+src(gh("preshed")) preshed]
-        +cell Cython hash tables that assume keys are pre-hashed
+        +cell
+            +src(gh("preshed")) preshed
+
+        +cell
+            |  Cython hash tables that assume keys are pre-hashed
 
     +row
-        +cell #[+src(gh("murmurhash")) murmurhash]
-        +cell Cython bindings for #[+a("https://en.wikipedia.org/wiki/MurmurHash") MurmurHash2].
+        +cell
+            +src(gh("murmurhash")) murmurhash
+
+        +cell
+            |  Cython bindings for
+            |  #[+a("https://en.wikipedia.org/wiki/MurmurHash") MurmurHash2].
 
 +h(2, "visualizers") Visualisers and demos
 
 +table(["Name", "Description"])
     +row
-        +cell #[+src(gh("displacy")) displaCy.js]
-        +cell A modern and service-independent dependency visualisation library for the modern web, built with JavaScript, CSS and SVG. #[+a(DEMOS_URL + "/displacy") Demo here].
+        +cell
+            +src(gh("displacy")) displaCy.js
+
+        +cell
+            |  A lightweight dependency visualisation library for the modern
+            |  web, built with JavaScript, CSS and SVG.
+            |  #[+a(DEMOS_URL + "/displacy") Demo here].
 
     +row
-        +cell #[+src(gh("displacy-ent")) displaCy#[sup ENT]]
-        +cell A lightweight and modern named entity visualisation library built with JavaScript and CSS. #[+a(DEMOS_URL + "/displacy-ent") Demo here].
+        +cell
+            +src(gh("displacy-ent")) displaCy#[sup ENT]
+
+        +cell
+            |  A lightweight and modern named entity visualisation library
+            |  built with JavaScript and CSS.
+            |  #[+a(DEMOS_URL + "/displacy-ent") Demo here].
 
     +row
-        +cell #[+src(gh("sense2vec-demo")) sense2vec Demo]
-        +cell Source of our Semantic Analysis of the Reddit Hivemind #[+a(DEMOS_URL + "/sense2vec") demo] using #[+a(gh("sense2vec")) sense2vec].
+        +cell
+            +src(gh("sense2vec-demo")) sense2vec Demo
+
+        +cell
+            |  Source of our Semantic Analysis of the Reddit Hivemind
+            |  #[+a(DEMOS_URL + "/sense2vec") demo] using
+            |  #[+a(gh("sense2vec")) sense2vec].