From b984e2d2ba450a1af8e56aa8f1610ce91e78dceb Mon Sep 17 00:00:00 2001
From: Mariano Montone <marianomontone@gmail.com>
Date: Tue, 15 May 2018 10:40:34 -0300
Subject: [PATCH] Get started page

---
 content/documentation.html     | 16 +++++++++-------
 content/downloads.html         | 16 +++++++++++++++-
 content/orphaned-projects.html |  1 +
 3 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/content/documentation.html b/content/documentation.html
index e979987..743b0f6 100644
--- a/content/documentation.html
+++ b/content/documentation.html
@@ -2,13 +2,13 @@
 
 <h1><i class="fa fa-book-open"></i> Documentation</h1>
 
-<section style="padding-top: 30px;">
+<section style="padding-top: 25px;">
   <h2><i class="fa fa-walking"></i>  Getting Started</h2>
   
   Check out <a href="/downloads">our guide</a> to get started.
 </section>
 
-<section style="padding-top: 30px;">
+<section style="padding-top: 25px;">
   <h2><i class="fa fa-book-open"></i>  Books</h2>
   <div class="row">
 
@@ -134,22 +134,24 @@
   <p>Look <a target="_blank" href="https://cliki.net/Lisp+Books">here</a> for a more complete list of books.</p>
 </section>
 
-<section style="padding-top: 30px;">
-  <h2><i class="fa fa-book"></i>  Specification</h2>
+<section style="padding-top: 25px;">
+  <h2><i class="fa fa-book"></i>  ANSI Common Lisp Specification</h2>
 
   <p>
-    <a href="http://www.lispworks.com/documentation/lw50/CLHS/Front/Contents.htm">Common Lisp HyperSpec (CLHS)</a>
+    <ul>
+      <li><a href="http://www.lispworks.com/documentation/lw50/CLHS/Front/Contents.htm">Common Lisp HyperSpec (CLHS)</a> - The Common Lisp HyperSpec (CLHS) is a non-free hyperlinked version of the ANSI Common Lisp Standard.</li>
+      <li><a href="http://cvberry.com/tech_writings/notes/common_lisp_standard_draft.html">Common Lisp Standard Draft (PDF)</a></li>
   </p>
 </section>
 
-<section style="padding-top: 30px;">
+<section style="padding-top: 25px;">
   <h2><i class="far fa-question-circle"></i>  Getting Help</h2>
 
   <p>If you need help, get in contact via <a href="/community">the Lisp mailing lists and IRC</a>.
   </p>
 </section>
 
-<section style="padding-top: 30px;">
+<section style="padding-top: 25px;">
   <h2>Other resources</h2>
 
   <ul>
diff --git a/content/downloads.html b/content/downloads.html
index 22aeee8..634aa61 100644
--- a/content/downloads.html
+++ b/content/downloads.html
@@ -42,6 +42,20 @@
 
 <h2>Setup your environment</h2>
 
+<p>A Lisp setup consists of three parts: a running Lisp instance, a text editor connected to that running Lisp instance, and project setup and libraries.</p>
+
+<p>The most common way is to use <a href="http://www.emacs.org">Emacs</a> and <a href="https://common-lisp.net/project/slime/">SLIME</a> as text editor/IDE and <a href="https://common-lisp.net/project/asdf/">ASDF</a> + <a href="http://www.quicklisp.org">Quicklisp</a> for project setup and libraries.</p>
+
+<p><a href="https://common-lisp.net/project/slime/">SLIME</a> is an extension to the Emacs text editor that connects the editor to the running Lisp image (called *inferior-lisp*) and interacts with it. It provides lisp code evaluation, compilation, and macroexpansion, online documentation, code navigation, objects inspection, debugger, and much much more.</p>
+
+<p><a href="https://common-lisp.net/project/asdf/">ASDF</a> is the Lisp version of Make. It is used to define projects (called systems), its dependencies, and load and compile the project.</p>
+
+<p><a href="https://www.quicklisp.org">Quicklisp</a> is a library manager for Common Lisp. Use it to download, install, and load any of over 1,500 libraries with a few simple commands.</p>
+
+<p>For an introduction on how to set them all up, you can have a look at <a href="http://articulate-lisp.com/">this guide</a>.</p>
+
+<p>You can also watch this video tutorial:</p>
+
 <p>
   <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#setup_video" aria-expanded="false" aria-controls="collapseExample">
     <i class="fa fa-play"></i>&nbsp;&nbsp;&nbsp;Watch an introductory video
@@ -79,7 +93,7 @@
 
 <p>Check out <a href="/libraries">this list</a> of Lisp libraries.</p>
 
-<p>The easiest way to download and load libraries is via <a href="http://www.quicklisp.org">Quicklisp</a>. <a href="http://articulate-lisp.com/quicklisp.html">Follow this instructions</a> to get started.</p>
+<p>The easiest way to download and load libraries is via <a href="http://www.quicklisp.org">Quicklisp</a>.  <a href="http://articulate-lisp.com/quicklisp.html">Follow these instructions</a> to get started.</p>
 
 <h2>Resources</h2>
 
diff --git a/content/orphaned-projects.html b/content/orphaned-projects.html
index a1cf224..8a6ceff 100644
--- a/content/orphaned-projects.html
+++ b/content/orphaned-projects.html
@@ -1,3 +1,4 @@
+<h1>Orphaned Projects</h1>
 <div id="bodyText">
   <h2 id="intro">Introduction</h2>
 
-- 
GitLab