Subject:
Feedback for WiMAX wiki
From:
Luisa Nevers <lnevers@bbn.com>
Date:
Wed, 05 Jan 2011 15:23:15 -0500
To:
harry.mussman@bbn.com, Abhimanyu Gosain <agosain@bbn.com>
CC:
Heidi Picher Dempsey <hpd@bbn.com>, Luisa Nevers <lnevers@bbn.com>

Hello,

I have just finished reviewing the WiMAX page at http://wimax.orbit-lab.org
and have captured all feedback, as a first time reader.  Please let me know
if the feedback is is not clear.

=> Overall Comments:

1. Navigation is cumbersome, the table of content is the only way to
   move through the lengthy document; the table of content is only
   available on the WikiStart page.  Suggest adding "Previous" and "Next"
   to navigate between chapters.

2. At the very top of every chapter there are 2 non-working
   links that looks as follows "WiMAX/NUM".  The "WiMax/" does not
   exist and the "/NUM"  is a number (00, 01, etc) and this link
   also does not work on any of the chapter pages.

=> Initial page "GENI WiMax Platform"

1. Should have link to GENI page, since this is a GENI project.
2. Are there other external web sites that should be referenced to
   provide some background to WiMAX?
3. Replace "modifed BS" with "modified BS"  in 3rd sentence.
4. Should spell out first instance of "BS" (Base Station).

=> Chapter 1 "GENI WiMAX System Configuration":

1. Configuration chapter starts with a diagram.  Needs some introduction
   to provide an overview of the configuration and its requirements. The
   picture is useful, but it should not be the starting point.

=> Section 1.2 "APIs"

1. Section provides a brief overview of the interaction between different
   system components as shown in the Figure 1.  These two components are
   described: Slice Manager (SM), Radio Management (RM), but neither component
   names are found in Figure 1.

=> Chapter 2 "GENI WiMAX Base Station Configuration"

1. Is the intent for the user to choose one of this configuration scenarios? Or
   is the intent of this page to have the user start with "Case 1" then move to
   "Case 2" and eventually end-up with "Case 3"?   Some text needed to explain
   the scope of this chapter.

=> Chapter 3 "Hardware"

1. I assume there is more to come in this section, right now, the hardware
   platforms listed are somewhat vague and incomplete.

=> Chapter 4 "Software"

1. Before any text is provided, chapter 4 starts with the following images
   in the order listed:
    Fig 2-1) Case 1 WiMAX Base Station Configuration
    Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
    Fig 4-1) Case 1 WiMAX Software Configuration
    Fig 2-2) Case 2 WiMAX Base Station Configuration
    Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
    Fig 4-2) Case 2 WiMAX Software Configuration
    
   The figure numbering scheme naming is confusing.  Need a small introduction
   to explain the scope of the chapter and how it will be presented to the user.

2. There 5 sentences (4.1, 4.2, 4.3.1, 4.4.1, 4.4.2) that tell the user to
   configuration file  by stating "see (reference below)". Should have link
   to the actual example.  I found it difficult to map each reference to the file.

=> Chapter 5 "Case 1: Software Installation, Configuration and Operation"
   Before any text is provided, chapter 5 starts with the following images
   in the order listed:
        Fig 2-1) Case 1 WiMAX Base Station Configuration
    Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
    Fig 4-1) Case 1 WiMAX Software Configuration

   Need a small introduction to explain the scope of the chapter

=> Section 5.1 "WiMAX OID and IP Address Assignment"

1. Section starts with a OID table that dives into the details of what is in
   use at various campuses and then provides some background.  Should explain
   and them provide the current table of OID & and IP addresses.

2.  There are two outstanding questions in this section that need answers.

=> Section 5.5 "Manual Configuration of SAMrb"

1. All configuration seems to be manual, why is this one identified as manual?
   Am I missing something?

=> Section 5.7 "Configuration of CLICK", suggest adding "router" to title.

1. Missing example configurations.


=> Section 5.8 "Operations and Testing":

1. Section 5.8.2 "Login to BTS" is missing example.

2. No information in the following sections:
    5.8.5 SAM Monitoring
    5.8.6 CLICK Modular Router Monitoring
    5.8.9 Mobile Station Registration

=> Chapter 6 "Case 2: Software Installation, Configuration and Operation"
   Before any text is provided, chapter 5 starts with the following images
   in the order listed:
        Fig 2-2) Case 2 WiMAX Base Station Configuration
    Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
    Fig 4-2) Case 2 WiMAX Software Configuration

   Need a small introduction to explain the scope of the chapter

=> Section 6.1 "WiMAX OID and IP Address Assignment"

1. Section starts with a OID table that dives into the details of what is in
   use and then provides some background.  Should explain and them provide
   the current table of OID & and IP addresses.

=> Section 6.6 "Configuration of CLICK", suggest adding "router" to title.

1. Missing example configurations.

=> Section 6.9 "Operations and Testing":

1. Section 6.9.2 "Login to BTS" is missing example.

2. No information in the following sections:
    6.9.5 SAM Monitoring
    6.9.6 CLICK Modular Router Monitoring
    6.9.7 Mobile Station Registration
    6.9.9 Login to OMF as Experimenter
    6.9.10 Use of OMF to Configure Service
    6.9.11 Use of OML to Monitor BTS
    6.9.12 Use of OML to Monitor Service

=> Chapter 7 "Case 3: Software Installation, Configuration and Operation" is empty.

=> Appendix A: "APIs"

1. Section A.2.1 "Sample Experiment Setup Using API" has macro error, missing figure

2. Section A.2.2 "Sample Experiment: Custom Service Class Control" has macro error, missing figure

=> Appendix B: "Errata/ Things we had to change but haven't formally committed to documentation"

1. Reference to non-existing "wiki:WiMAX/Software/Configuration"

=> Appendix C: "WiMAX Mobile Stations"

1. Section c.1.1 "Installing image" point user to "Geni Configuration Instructions"
   which is a link to "http://wimax.orbit-lab.org/downloads/NDnSAgentConfig_forDriver"
   this does not exist.


Luisa