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.
On Sun June 24 2007 12:38 am, Matthew Fulmer wrote:
Still to be done:
- figure out what to do with the links at the bottom of the page. Especially the link to squeaknews.com.
the squeaknews link can be removed. We already have a feed and links on the right side of every page.
On Sun June 24 2007 9:59 am, Brad Fuller wrote:
On Sun June 24 2007 12:38 am, Matthew Fulmer wrote:
Still to be done:
- figure out what to do with the links at the bottom of the page. Especially the link to squeaknews.com.
the squeaknews link can be removed. We already have a feed and links on the right side of every page.
oppss.. ken pointed out that squeaknews.com is not news.squeak.org
please ignore my msg
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
On Sun, Jun 24, 2007 at 12:38:21AM -0700, 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.
One more change: I put Stephan Wessel's excellent tutorial at the very top of the 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.
I punted on this issue. I deleted the rest of the page and put it at http://wiki.squeak.org/493 . Except for the books and papers, there was nothing particularly interesting on the rest of the page. I will try to make a good book list, similar to my tutorial list, soon.
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
Thanks to Stephan's new tutorial and Squeak by Example, I would say this goal has been met. I moved the contents of the test site to the main site
From: Matthew Fulmer tapplek@gmail.com To: webteam@lists.squeakfoundation.org,Squeak documentation team squeak-doc@lists.squeakfoundation.org Subject: Re: [Webteam] Documentation page update Date: Tue, 3 Jul 2007 18:35:18 -0700
On Sun, Jun 24, 2007 at 12:38:21AM -0700, Matthew Fulmer wrote:
On Thu, Jun 07, 2007 at 06:50:54PM -0700, Matthew Fulmer wrote:
I punted on this issue. I deleted the rest of the page and put it at http://wiki.squeak.org/493 . Except for the books and papers, there was nothing particularly interesting on the rest of the page. I will try to make a good book list, similar to my tutorial list, soon.
Was there a typo in the link? I clicked on that link but I got a 404 error : The requested URL (http://127.0.0.1:8080/493) was not found on this server.
Larry Trutter
_________________________________________________________________ http://newlivehotmail.com
On Thu, Jul 05, 2007 at 06:39:00AM -0500, Larry Trutter wrote:
From: Matthew Fulmer tapplek@gmail.com To: webteam@lists.squeakfoundation.org,Squeak documentation team squeak-doc@lists.squeakfoundation.org Subject: Re: [Webteam] Documentation page update Date: Tue, 3 Jul 2007 18:35:18 -0700
On Sun, Jun 24, 2007 at 12:38:21AM -0700, Matthew Fulmer wrote:
On Thu, Jun 07, 2007 at 06:50:54PM -0700, Matthew Fulmer wrote:
I punted on this issue. I deleted the rest of the page and put it at http://wiki.squeak.org/493 . Except for the books and papers, there was nothing particularly interesting on the rest of the page. I will try to make a good book list, similar to my tutorial list, soon.
Was there a typo in the link? I clicked on that link but I got a 404 error : The requested URL (http://127.0.0.1:8080/493) was not found on this server.
yes; it should be http://wiki.squeak.org/squeak/493
squeak-doc@lists.squeakfoundation.org