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

[Matthew Fulmer]

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

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.
- 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" ?

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

-- 
Matthew Fulmer -- http://mtfulmer.wordpress.com/
Help improve Squeak Documentation: http://wiki.squeak.org/squeak/808