From f8b2472fd5a15132dd6d910e560b5700f05a269b Mon Sep 17 00:00:00 2001
From: Andy Gunn <andygunn@opentechinstitute.org>
Date: Mon, 24 Nov 2014 13:54:57 -0500
Subject: [PATCH] Added more descriptive text to the CCK index pages. Should
 help folks find what they need.

---
 .../_includes/cck/building-mounting-modules.html |  3 +++
 .../cck/installing-configuring-modules.html      | 16 +++++++++++++++-
 .../cck/local-applications-modules.html          |  3 +++
 .../_includes/cck/networking-modules.html        | 10 +++++++++-
 .../_includes/cck/planning-modules.html          | 14 +++++++++++---
 5 files changed, 41 insertions(+), 5 deletions(-)

diff --git a/commotionwireless.net/_includes/cck/building-mounting-modules.html b/commotionwireless.net/_includes/cck/building-mounting-modules.html
index ab8a6c6b..d47cd197 100644
--- a/commotionwireless.net/_includes/cck/building-mounting-modules.html
+++ b/commotionwireless.net/_includes/cck/building-mounting-modules.html
@@ -1,3 +1,6 @@
+<p>
+If you are building a wireless network that covers a wide area, such as a town or large neighborhood, you may need to install some routers outdoors or on rooftops. Consult the guides and documents below for some help on selecting the proper tools, hardware, and mounting kits - as well as a few tips on effective and safe installation methods.
+</p>
 <ul>
 	<li><a href="/docs/cck/building-mounting/gather-tools-and-wireless-equipment">Gather Tools and Wireless Equipment</a>: A list of suggested tools and equipment to use for installing wireless hardware.</li>
 	<li><a href="/docs/cck/building-mounting/learn-rooftop-basics">Learn Rooftop Basics</a>: Tips for working on roofs.</li>
diff --git a/commotionwireless.net/_includes/cck/installing-configuring-modules.html b/commotionwireless.net/_includes/cck/installing-configuring-modules.html
index 5366ca2d..ca62640e 100644
--- a/commotionwireless.net/_includes/cck/installing-configuring-modules.html
+++ b/commotionwireless.net/_includes/cck/installing-configuring-modules.html
@@ -1,10 +1,24 @@
+<p>
+Commotion is supported on several types of routers. The installation process is different depending on the type. Use the installation guides below, specific to your equipment:
+</p>
 <ul>
 	<li><a href="/docs/cck/installing-configuring/install-ubiquiti-router">Install on a Ubiquiti AirMax Router</a>: A step-by-step process for installing Commotion Wireless on Ubiquiti AirMax routers, which are amenable to changing operating systems.</li>
 	<li><a href="/docs/cck/installing-configuring/install-unifi-router">Install on a Ubiquiti UniFi Router</a>: A step-by-step process for installing Commotion Wireless on Ubiquiti UniFi routers, though it is less user friendly than AirMax devices.</li>
 	<li><a href="/docs/cck/installing-configuring/install-tplink-router">Install on a TP-Link Router</a>: A step-by-step process for installing Commotion Wireless on TP-Link routers, which are amenable to changing operating systems.</li>
+	<li><a href="/docs/cck/installing-configuring/install-mikrotik-router">Install on a MikroTik Router</a>: A step-by-step process for installing Commotion Wireless on MikroTik RouterBoards. This is an advanced process and requires using DHCP server software.</li>
+</ul>
+<p>
+After installing Commotion on your router, you will need to run through the Setup Wizard and configure the node. Review the configuration and hardware setup guides below for information on setting up the software, and connecting multiple mesh nodes in various configurations.
+</p>
+<ul>
 	<li><a href="/docs/cck/installing-configuring/configure-commotion">Configure Commotion</a>: Instructions on configuring a Commotion wireless node through the Commotion Setup Wizard and through the administration interface.</li>
 	<li><a href="/docs/cck/installing-configuring/common-hardware-setups/">Common Hardware Setups</a>: How a node should be configured depends on how it needs to funtion on the mesh network. Learn about the most common Commotion configurations.</li>
-	<li><a href="/docs/cck/installing-configuring/advanced-hardware-setups/">Advanced Hardware Setups</a>: For hardware configurations that involve multiple nodes at a single site, or other unique situations, this guide provides instructions.</li>
+	<li><a href="/docs/cck/installing-configuring/advanced-hardware-setups/">Advanced Hardware Setups</a>: For hardware setups that involve multiple nodes at a single site, or other unique situations, this guide provides examples and configuration instructions.</li>
+</ul>
+<p>
+If you run in to issues with the configuration of your routers, or the connections between routers, you can try these troubleshooting and router recovery guides.
+</p>
+<ul>
 	<li><a href="/docs/cck/installing-configuring/troubleshoot-your-wireless-node">Troubleshoot Your Wireless Node</a>: Includes steps to identify and solve the most common problems that may arise with your Commotion router or wireless network.</li>
 	<li><a href="/docs/cck/installing-configuring/install-and-recover-tftp">Install and Recover with TFTP</a>: An alternate installation process if the regular approach does not work or there is a problem with installing Commotion Wireless.</li>
 </ul>
diff --git a/commotionwireless.net/_includes/cck/local-applications-modules.html b/commotionwireless.net/_includes/cck/local-applications-modules.html
index 3cf5964b..8f30d672 100644
--- a/commotionwireless.net/_includes/cck/local-applications-modules.html
+++ b/commotionwireless.net/_includes/cck/local-applications-modules.html
@@ -1,3 +1,6 @@
+<p>
+Community or neighborhood networks are set apart by the ability to host unique and local applications. These can be tailored to whatever your community needs or wants, and installed on a computer or server anywhere on the network. The guides below can help you think about how to plan for local applications and set them up on the network.
+</p>
 <ul>
 	<li><a href="/docs/cck/local-applications/what-is-an-app">What is an App?</a>: An introductory guide to applications.</li>
 	<li><a href="/docs/cck/local-applications/locating-a-local-server">Locating a Local Server</a>: How to decide where to put a local server.</li>
diff --git a/commotionwireless.net/_includes/cck/networking-modules.html b/commotionwireless.net/_includes/cck/networking-modules.html
index 1cf8fd4d..4d6263b9 100644
--- a/commotionwireless.net/_includes/cck/networking-modules.html
+++ b/commotionwireless.net/_includes/cck/networking-modules.html
@@ -1,6 +1,14 @@
+<p>
+Building a mesh network will involve some knowledge of wireless networking. There may already be members of your community with the knowledge and experience to share, but these materials can be used as guides or tools to further share the information with those that don't have much background.
+</p>
 <ul>
 	<li><a href="/docs/cck/networking/intro-to-mesh">Introduction to Mesh</a>: An introduction to mesh and network properties.</li>
 	<li><a href="/docs/cck/networking/learn-networking-basics">Learn Networking Basics</a>: An introductory guide to networking.</li>
 	<li><a href="/docs/cck/networking/learn-wireless-basics">Learn Wireless Basics</a>: An introduction to how wireless technology works.</li>
-	<li><a href="/docs/cck/networking/wireless-challenges">Design your Network: Wireless Challenges</a>: A simple guide to wireless challenges to help improve network planning&nbsp;and troubleshooting.</li>
+</ul>
+<p>
+As networks grow and change, there are often issues that must be resolved. Wireless interference is one of them, and the guide below can help your community learn about how to solve it.
+</p>
+<ul>
+	<li><a href="/docs/cck/networking/wireless-challenges">Design your Network: Wireless Challenges</a>: An activity to think about wireless issues that come up, to help improve network planning and troubleshooting.</li>
 </ul>
diff --git a/commotionwireless.net/_includes/cck/planning-modules.html b/commotionwireless.net/_includes/cck/planning-modules.html
index c3c5550a..2e4bad78 100644
--- a/commotionwireless.net/_includes/cck/planning-modules.html
+++ b/commotionwireless.net/_includes/cck/planning-modules.html
@@ -1,8 +1,16 @@
+<p>
+The first steps in building a wireless network with your community involve organizing and planning. The guides below help with identifying individuals in your neighborhood or community that can help, places to mount equipment, and important organizations to include in the planning process.
+</p>
 <ul>
-	<li><a href="/docs/cck/planning/design-your-network-every-network-tells-story">Design your Network: Every Network Tells a Story</a>: A game that helps communities think through network planning and the&nbsp;social networks upon which community wireless relies.</li>
+	<li><a href="/docs/cck/planning/design-your-network-every-network-tells-story">Design your Network: Every Network Tells a Story</a>: A game that helps communities think through network planning and the social networks upon which community wireless relies.</li>
 	<li><a href="/docs/cck/planning/survey-your-neighbors">Survey your Neighbors</a>: Description of how to design a survey for your community, conduct it, analyze the results, and follow-up with the community.</li>
-	<li><a href="/docs/cck/planning/get-word-out-flyer-design">Get the Word Out: Flyer Design</a>: Step-by-step suggestions for making a flyer for your wireless project, including examples.</li>
-	<li><a href="/docs/cck/planning/identify-neighborhood-skills">Identify Neighborhood Skills</a>: Activities to help identify important organizing, tech, and handy-person&nbsp;skills for your wireless project.</li>
+	<li><a href="/docs/cck/planning/identify-neighborhood-skills">Identify Neighborhood Skills</a>: Activities to help identify important organizing, tech, and handy-person skills for your wireless project.</li>
 	<li><a href="/docs/cck/planning/inventory-the-neighborhood">Inventory the Neighborhood</a>: Guide to surveying your neighborhood for wireless assets and challenges.</li>
+</ul>
+<p>
+During the planning or installation process, you may want to inform the community about the network, or seek further help. The guides below can help with some of the process and graphics used when making an outreach flyer or brochure.
+</p>
+<ul>
+	<li><a href="/docs/cck/planning/get-word-out-flyer-design">Get the Word Out: Flyer Design</a>: Step-by-step suggestions for making a flyer for your wireless project, including examples.</li>
 	<li><a href="/docs/cck/planning/design-your-network-construction-elements">Design your Network: Construction Elements</a>: Simple graphics for making flyers, planning diagrams, or other materials, using scissors and paper or a computer design program.</li>
 </ul>