GIR3.1_WIMAX: Feedback-WiMAX-wik-20110105.txt

File Feedback-WiMAX-wik-20110105.txt, 6.3 KB (added by lnevers@bbn.com, 9 years ago)
Line 
1Subject:
2Feedback for WiMAX wiki
3From:
4Luisa Nevers <lnevers@bbn.com>
5Date:
6Wed, 05 Jan 2011 15:23:15 -0500
7To:
8harry.mussman@bbn.com, Abhimanyu Gosain <agosain@bbn.com>
9CC:
10Heidi Picher Dempsey <hpd@bbn.com>, Luisa Nevers <lnevers@bbn.com>
11
12Hello,
13
14I have just finished reviewing the WiMAX page at http://wimax.orbit-lab.org
15and have captured all feedback, as a first time reader.  Please let me know
16if the feedback is is not clear.
17
18=> Overall Comments:
19
201. Navigation is cumbersome, the table of content is the only way to
21   move through the lengthy document; the table of content is only
22   available on the WikiStart page.  Suggest adding "Previous" and "Next"
23   to navigate between chapters.
24
252. At the very top of every chapter there are 2 non-working
26   links that looks as follows "WiMAX/NUM".  The "WiMax/" does not
27   exist and the "/NUM"  is a number (00, 01, etc) and this link
28   also does not work on any of the chapter pages.
29
30=> Initial page "GENI WiMax Platform"
31
321. Should have link to GENI page, since this is a GENI project.
332. Are there other external web sites that should be referenced to
34   provide some background to WiMAX?
353. Replace "modifed BS" with "modified BS"  in 3rd sentence.
364. Should spell out first instance of "BS" (Base Station).
37
38=> Chapter 1 "GENI WiMAX System Configuration":
39
401. Configuration chapter starts with a diagram.  Needs some introduction
41   to provide an overview of the configuration and its requirements. The
42   picture is useful, but it should not be the starting point.
43
44=> Section 1.2 "APIs"
45
461. Section provides a brief overview of the interaction between different
47   system components as shown in the Figure 1.  These two components are
48   described: Slice Manager (SM), Radio Management (RM), but neither component
49   names are found in Figure 1.
50
51=> Chapter 2 "GENI WiMAX Base Station Configuration"
52
531. Is the intent for the user to choose one of this configuration scenarios? Or
54   is the intent of this page to have the user start with "Case 1" then move to
55   "Case 2" and eventually end-up with "Case 3"?   Some text needed to explain
56   the scope of this chapter.
57
58=> Chapter 3 "Hardware"
59
601. I assume there is more to come in this section, right now, the hardware
61   platforms listed are somewhat vague and incomplete.
62
63=> Chapter 4 "Software"
64
651. Before any text is provided, chapter 4 starts with the following images
66   in the order listed:
67    Fig 2-1) Case 1 WiMAX Base Station Configuration
68    Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
69    Fig 4-1) Case 1 WiMAX Software Configuration
70    Fig 2-2) Case 2 WiMAX Base Station Configuration
71    Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
72    Fig 4-2) Case 2 WiMAX Software Configuration
73   
74   The figure numbering scheme naming is confusing.  Need a small introduction
75   to explain the scope of the chapter and how it will be presented to the user.
76
772. There 5 sentences (4.1, 4.2, 4.3.1, 4.4.1, 4.4.2) that tell the user to
78   configuration file  by stating "see (reference below)". Should have link
79   to the actual example.  I found it difficult to map each reference to the file.
80
81=> Chapter 5 "Case 1: Software Installation, Configuration and Operation"
82   Before any text is provided, chapter 5 starts with the following images
83   in the order listed:
84        Fig 2-1) Case 1 WiMAX Base Station Configuration
85    Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
86    Fig 4-1) Case 1 WiMAX Software Configuration
87
88   Need a small introduction to explain the scope of the chapter
89
90=> Section 5.1 "WiMAX OID and IP Address Assignment"
91
921. Section starts with a OID table that dives into the details of what is in
93   use at various campuses and then provides some background.  Should explain
94   and them provide the current table of OID & and IP addresses.
95
962.  There are two outstanding questions in this section that need answers.
97
98=> Section 5.5 "Manual Configuration of SAMrb"
99
1001. All configuration seems to be manual, why is this one identified as manual?
101   Am I missing something?
102
103=> Section 5.7 "Configuration of CLICK", suggest adding "router" to title.
104
1051. Missing example configurations.
106
107
108=> Section 5.8 "Operations and Testing":
109
1101. Section 5.8.2 "Login to BTS" is missing example.
111
1122. No information in the following sections:
113    5.8.5 SAM Monitoring
114    5.8.6 CLICK Modular Router Monitoring
115    5.8.9 Mobile Station Registration
116
117=> Chapter 6 "Case 2: Software Installation, Configuration and Operation"
118   Before any text is provided, chapter 5 starts with the following images
119   in the order listed:
120        Fig 2-2) Case 2 WiMAX Base Station Configuration
121    Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
122    Fig 4-2) Case 2 WiMAX Software Configuration
123
124   Need a small introduction to explain the scope of the chapter
125
126=> Section 6.1 "WiMAX OID and IP Address Assignment"
127
1281. Section starts with a OID table that dives into the details of what is in
129   use and then provides some background.  Should explain and them provide
130   the current table of OID & and IP addresses.
131
132=> Section 6.6 "Configuration of CLICK", suggest adding "router" to title.
133
1341. Missing example configurations.
135
136=> Section 6.9 "Operations and Testing":
137
1381. Section 6.9.2 "Login to BTS" is missing example.
139
1402. No information in the following sections:
141    6.9.5 SAM Monitoring
142    6.9.6 CLICK Modular Router Monitoring
143    6.9.7 Mobile Station Registration
144    6.9.9 Login to OMF as Experimenter
145    6.9.10 Use of OMF to Configure Service
146    6.9.11 Use of OML to Monitor BTS
147    6.9.12 Use of OML to Monitor Service
148
149=> Chapter 7 "Case 3: Software Installation, Configuration and Operation" is empty.
150
151=> Appendix A: "APIs"
152
1531. Section A.2.1 "Sample Experiment Setup Using API" has macro error, missing figure
154
1552. Section A.2.2 "Sample Experiment: Custom Service Class Control" has macro error, missing figure
156
157=> Appendix B: "Errata/ Things we had to change but haven't formally committed to documentation"
158
1591. Reference to non-existing "wiki:WiMAX/Software/Configuration"
160
161=> Appendix C: "WiMAX Mobile Stations"
162
1631. Section c.1.1 "Installing image" point user to "Geni Configuration Instructions"
164   which is a link to "http://wimax.orbit-lab.org/downloads/NDnSAgentConfig_forDriver"
165   this does not exist.
166
167
168Luisa
169
170