[Webteam] Documentation page update

[Brad Fuller]

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./
   5.
         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

-------------- next part --------------
Skipped content of type multipart/related