Wireless Networking page - Introduction

Peter Naulls peter at chocky.org
Tue Aug 5 01:32:24 CEST 2008

Brian Wilson wrote:
>>> I have added a small introduction section to the Wireless Networking page:
>>> http://wiki.openmoko.org/wiki/Wireless_Networking
>>> Do you think it is a good idea to have such introductions?
> Yes, absolutely. Unless the page has only one or two paragraphs I
> think you should assume that the person coming into the page is a
> beginner and give them an intro. Then a beginner can start at the top
> and not immediately feel lost. I usually call that section "Overview"
> and tell what the page is about first. Advanced users can skim over
> the Overview and go right to the potatoes of the page. (I am a
> vegetarian so my pages are meat free. :-)

Yes it is.  As I noted earlier, I want to try any maintain
some oversight on all the networking pages.  I haven't yet
spent any real time with the WiFi page, which is why
I haven't any but minor updates to this year.  IMO, the
content there currently is a complete and confusing mess,
and once I understand all the issues, I will try and
assemble a process much like I did on the USB Networking page,
which leads through something which will work for > 95% of users.

 > "Wireless Networking" could also include GPRS, Zigbee, etc, which is

Yeah, I know, and actually I renamed it to this after suggestions
on the talk page, and worse, in the context of phones, it
much more likely refers to the cell technology rather than WiFi.
I don't mind it being renamed again, and certainly some
disambiguation is called for.

Finally, we also need a page for GSM networking, if you have
a data connection (I have an AT&T data plan SIM I can use).

More information about the documentation mailing list