[Squeak-doc] Re: [Webteam] Documentation page update

[karl]

Matthew Fulmer wrote:
> On Thu, Jun 07, 2007 at 06:50:54PM -0700, Matthew Fulmer wrote:
>   
>> 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? 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.
>>     
>
> A few more changes:
> - I removed those search boxes from the documentation page. 
> - I also re-organized the top few sections, merging the video,
>   book, and tutorial list into a "Useful Resources" heading. 
> - Added the "Discovering Better Code Series" as a top-document,
>   as it was particularly useful today, as someone was looking
>   for a document on exactly that topic
> - Moved the link to http://squeak.joyful.com/Sites to the
>   "Community" page
> - Replaced links to irc and the mailing list with a single link
>   to the Community page
>   

This page looks good.

> Still to be done:
> - figure out what to do with the links at the bottom of the
>   page. Especially the link to squeaknews.com. I am examining
>   that site to see what is there; unfortunately, my system is
>   not able to mount their zipped ISO images right now, due to
>   some error with my /dev/loop device.
>   

As the stuff on the Squeaknews site starts to get old I think the link 
can be moved over to the swiki

> - Move the section "Exploring the code" onto a dedicated wiki
>   page. I am sure an appropriate page exists, but I need to go
>   to bed.
>
> My goal for this page is to be able to point to it as "the"
> place to direct anyone unfamiliar with squeak able to operate
> the system. More specifically, I am about to start a Seaside
> tutorial, and I want to be able to assume that the reader is
> already familiar with Squeak. I would like to justify that
> assumption with only one link:
> http://www.squeak.org/Documentation
>
> How well does the page meet that criteria? Is it a valid
> criteria? If so, should the page be renamed "Getting Started" ?
>   

I think documentation is better.

>   
>> 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.
>>     
>
> Still todo.
>
>   
Karl