From 9375fb32be5bde81ba3a2ce807840570107c7284 Mon Sep 17 00:00:00 2001
From: rsiddharth <rsd@gnu.org>
Date: Thu, 26 May 2016 19:00:04 +0000
Subject: docs: reorganized lp speakers.

---
 docs/speakers/index.rst | 28 ++++++++++++++++------------
 1 file changed, 16 insertions(+), 12 deletions(-)

(limited to 'docs/speakers/index.rst')

diff --git a/docs/speakers/index.rst b/docs/speakers/index.rst
index 8bc28eb..f98dbdb 100644
--- a/docs/speakers/index.rst
+++ b/docs/speakers/index.rst
@@ -3,18 +3,8 @@
 LP speakers
 -----------
 
-LP speakers usage
-~~~~~~~~~~~~~~~~~
-::
-
-   $ lps_gen -sp path/to/lp-speakers.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html
-
-or::
-
-  $ lps_gen --speakers path/to/lp-speakers.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html
-
-LP speakers markdown structure
-``````````````````````````````
+Markdown structure
+~~~~~~~~~~~~~~~~~~
 
 ::
 
@@ -68,3 +58,17 @@ speaker' name is "John Hacker", the ID for this speaker will be
 
 - The IDs are transliterated to ASCII; if a speaker' name is "John
   HÖcker", the ID for this speaker will be ``hacker``.
+
+Generate HTML from Markdown
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+::
+
+   $ lps_gen -sp path/to/lp-speakers.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html
+
+or::
+
+  $ lps_gen --speakers path/to/lp-speakers.jinja2 path/to/lp-speakers.md > path/to/speakers-content.html
+
+If you run into issues, ask for :ref:`help <lps-doc-sec-help>`.
+
+Next, you might want to look at the :ref:`lps-doc-sec-schedule` section or the :ref:`lps-doc-sec-general` section.
-- 
cgit v1.2.3