Matthew Fulmer wrote: 
On Thu, Jun 07, 2007 at 06:24:51PM -0700, Brad Fuller wrote:
  
Matthew Fulmer wrote:
    
I am considering doing a large overhaul on the documentation
page on wwwtest.squeak.org. I started by fixing the broken links
on the wwwtest site which had already been fixed on the main
page. 
  
      
The use of "Documentation" is a bit of a misnomer for this page. It
really is a collection of useful ways to search and learn about squeak. 
Maybe we should think of another title instead of "documentation", as I
do think something like this would be good on the main site (and point
to the real documentation on the wiki.)

Maybe rename to "Resources"?
Then provide useful ways to learn about squeak, including pointing to
documentation.
    

I don't really like the name Resources. "Resources" makes me
think of things that make up a system and keep it going. Kind of
generic. Either name would work, I guess.
I think "Resources" is better than "Documentation".

==
re·source (rē'sôrs', -sōrs', -zôrs', -zōrs', rĭ-sôrs', -sōrs', -zôrs', -zōrs') pronunciation
n.
  1. Something that can be used for support or help: The local library is a valuable resource.
  2. An available supply that can be drawn on when needed. Often used in the plural.
  3. The ability to deal with a difficult or troublesome situation effectively; initiative: a person of resource.
  4. Means that can be used to cope with a difficult situation. Often used in the plural: needed all my intellectual resources for the exam.
    1. resources The total means available for economic and political development, such as mineral wealth, labor force, and armaments.
    2. resources The total means available to a company for increasing production or profit, including plant, labor, and raw material; assets.
    3. Such means considered individually.
===

Maybe someone could come up with a better name.

Regarding specific parts of the page, Those Google search boxes
look really weird to me, and I would never think to come use
them. Would there be a way to put those as drop-down choices on
some search box at the top of www.squeak.org?
I don't know. There already is a "search" link on the top right of the page.

that is how
several other sites do it. Or just put a search box up there
that searches the website, the Swiki, SqueakPeople, the mailing
lists, and (maybe) the IRC logs.

The doc team should probably move most of those links off the
website and put them into a bigger, easier list on the Swiki,
kind of like I did with the tutorial list.
Good idea. I bet the google search is better than the swiki search, though. That one is not too good.
If so, it'd be nice to repoint the wiki search to a page where one could search using google. Maybe having a list of boxes.

There is also this:
http://google.com/coop/cse?cx=008315932112852043911%3Ayuibfrpnbc0

-- 
brad fuller
 www.bradfuller.com
 +1 (408) 799-6124