Re: Working on backup solution, can you do some cleanup?

On Mon, 2007-06-04 at 18:25 -0400, Jason Rogers wrote:
> Done.  I forgot to set the execute bit on the removal script.

Thanks Jason, this has made all the difference, you are now down to
2.9GB.

Ken

Documentation page and the test site

I was given an account to the squeak.org website in order to
maintain the http://squeak.org/Documentation/ page. I also
recently used my account to link to the Mailing list page on the
Swiki, which I recently re-vamped
(http://wiki.squeak.org/squeak/608). But I also see there is a
http://wwwtest.squeak.org site. Should I be making changes there
and letting the webteam port them over? I am not familiar with
the policy. 

--

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

Re: Documentation page and the test site

We usually make changes to the wwwtest site first. Get everyone's
approval before moving it over to the  real site.

Matthew Fulmer wrote:
> I was given an account to the squeak.org website in order to
> maintain the http://squeak.org/Documentation/ page. I also
> recently used my account to link to the Mailing list page on the
> Swiki, which I recently re-vamped
> (http://wiki.squeak.org/squeak/608). But I also see there is a
> http://wwwtest.squeak.org site. Should I be making changes there
> and letting the webteam port them over? I am not familiar with
> the policy. 
>
>   

--

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

Re: Documentation page and the test site

On Thu, Jun 07, 2007 at 04:14:48PM -0700, Brad Fuller wrote:
> We usually make changes to the wwwtest site first. Get everyone's
> approval before moving it over to the  real site.

Ok. I will revert and announce my changes as soon as possible.
Sorry.

> Matthew Fulmer wrote:
> > I was given an account to the squeak.org website in order to
> > maintain the http://squeak.org/Documentation/ page. I also
> > recently used my account to link to the Mailing list page on the
> > Swiki, which I recently re-vamped
> > (http://wiki.squeak.org/squeak/608). But I also see there is a
> > http://wwwtest.squeak.org site. Should I be making changes there
> > and letting the webteam port them over? I am not familiar with
> > the policy. 

--

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

Re: Documentation page and the test site

Community page > Mailing List

I replaced the Squeak mailing list page on the Swiki with a list
of the most popular Squeak list, along with their mirrors on
gmane and nabble:
http://wiki.squeak.org/squeak/608

I also replaced a few links on the community page, under the
Mailing List header, on wwwtest.squeak.org. Comments on both the
Swiki change and the website change are welcome.

--

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

Documentation page update

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. 

I think that the Documentation page should link to the best
documentation at the top, and only later point the user at the
heap of out-of-date stuff. So I put links to Squeak by Example
and my tutorial list at the top in nice-looking <h2> headers,
and removed the Tutorials section, as my tutorial list is much
better (imho). However, That is only two links on the rather
large page, and they do not seem eye-catching at all. I am no
web designer, so I am not sure how to fix this. Also, are there
other docs we could put there that are not slightly embarrassing
to show noobs?

Two things that are especially nice from my collection [1] are
Maarten Maartensz's Squeak pages :
http://www.maartensz.org/computing/squeak/squeak_index.htm
and Stephane Ducasse's Smalltalk Exercises:
http://stephane.ducasse.free.fr/Teaching/CoursAnnecy/0506-M1-OOP/OOPAvance.pdf

Please help.

[1]: My collection of Squeak stuff; most are useful:
http://wiki.squeak.org/squeak/5871

PS. I am not sure whether to cross-post this message to the
doc-team list, so I did not. I am not sure if there is or should
be a definable separation of duties between the two team's goals

--

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

Re: Community page > Mailing List

Matthew Fulmer wrote:
> I replaced the Squeak mailing list page on the Swiki with a list
> of the most popular Squeak list, along with their mirrors on
> gmane and nabble:
> http://wiki.squeak.org/squeak/608
>
> I also replaced a few links on the community page, under the
> Mailing List header, on wwwtest.squeak.org. Comments on both the
> Swiki change and the website change are welcome.
>   
Thanks for doing this Matthew!

I propose to have only one place that lists all mailing lists  - either
on the wiki or on the squeak site, but not both. The other page can
point to it and can even reference a few of the major mailing lists to
help the reader understand what they are.

This both helps confusion to the visitor and helps maintenance issues
when lists are added, deleted or changed.

--

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

Web team, Doc team, and Swiki cleanup

Cross-posted to both the web team list and the doc-team list.
Sorry.

In the postscript to my last message to the web team, an old
uncertainty I have had for a while crept up. What is (or should
be) the separate duties of the web and doc teams?

By my understanding, the Web team is solely responsible for the
maintenance of the www.squeak.org site. I started the Doc team,
because I saw a lack of good tutorials, but mostly what I have
been doing is Swiki cleanup, which seems more like website
maintenance work. The other members of the doc team have been
writing tutorials and screencasts, but not me.

This is not really a problem until one wants to collaborate with
others on a particular cleanup task. Simon Michael has said he
would be interested in such a task. Perhaps Swiki cleanup could
be a joint effort between the doc team and web teams, and we
could host a "Page of the week/month" type focus. That seems
quite on target with the web-team list, where folks gather to
discuss page edits. Might that be a good idea? If so, where
should it be hosted? on the web team list? the doc team list? or
on the Swiki? I don't want to have to cross-post again.

If there is interest, I know just where to start... 

--

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

Re: Documentation page update

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.

> PS. I am not sure whether to cross-post this message to the
> doc-team list, so I did not. I am not sure if there is or should
> be a definable separation of duties between the two team's goals
>   
My take is that the documentation team is slated to provide ways for
people to learn and edumacate themselves about squeak's environment, the
smalltalk language, etc. I thought the team was going to create better
documentation about the classes/methods and also provide links to all
the wonderful documentation resources on the web (and at Amazon!)

I think it would also be nice if the documentation team helped
developers, or build processes for them, so programmers find it easier
(or force them to!) write documentation about their apps/code in the
future (thus helping you from continually writing documentation!)

I think the webteam is responsible for maintaining the website that
provides a frontend to everything about squeak. That includes ways to
find the documentation, but also other important things that other
groups are responsible for. For instance,  the Foundation, where and how
to download the latest squeak, providing some advertising and PR about
squeak (e.g. the Features page.)

So, I see them different.

--

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