lonnie
04-11-2006, 05:20 PM
Carl Davis has stepped forward to take a shot at the manual. Below is part of his email to me. Carl is helping on some other programming tasks and I can assure you his main tasks are more important than documenting the obvious. So, keep your requests technical and to the point. Please make sure your requests are not real basic and also make sure you have read the existing manual.
I hate to have to say this but, Carl is not your research resource. He will do his best to help with a manual but he has other things with a higher priority, so I am asking that you really have a good try at figuring it out on your own. If it just does not come to you then please request a clarification or more documentation.
QUOTE
I saw several gripes about a lack of docs as well as threats of people dropping StarOS if they can't get docs. I am interested in heading up some documentation but I need some guidance as to what should be documented. My way of thinking is that a certain amount of knowledge is assumed (knowing a route from a root, knowing what an ESSID is as well as an IP address is). Given that premise, there isn't really a lot that could be generalized into documentation because the menu style and order is pretty much self-explanatory.
So, I have this to propose if you would like:
If you would be willing to start a thread named "Documentation Wishes" or something like it, I would be happy to collect peoples wishes over a period of time (say two weeks) and then begin creating, or modifying the current, documentation and leave specialized requests to the forum where they belong.
END QUOTE
So, keep this to the point. We are not doing a TCP how-to and it is assumed that you have a basic understanding of networking and wireless in general.
I hate to have to say this but, Carl is not your research resource. He will do his best to help with a manual but he has other things with a higher priority, so I am asking that you really have a good try at figuring it out on your own. If it just does not come to you then please request a clarification or more documentation.
QUOTE
I saw several gripes about a lack of docs as well as threats of people dropping StarOS if they can't get docs. I am interested in heading up some documentation but I need some guidance as to what should be documented. My way of thinking is that a certain amount of knowledge is assumed (knowing a route from a root, knowing what an ESSID is as well as an IP address is). Given that premise, there isn't really a lot that could be generalized into documentation because the menu style and order is pretty much self-explanatory.
So, I have this to propose if you would like:
If you would be willing to start a thread named "Documentation Wishes" or something like it, I would be happy to collect peoples wishes over a period of time (say two weeks) and then begin creating, or modifying the current, documentation and leave specialized requests to the forum where they belong.
END QUOTE
So, keep this to the point. We are not doing a TCP how-to and it is assumed that you have a basic understanding of networking and wireless in general.