[Webteam] Documentation page update

Matthew Fulmer tapplek at gmail.com
Fri Jun 8 00:57:05 UTC 2007


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


More information about the Webteam mailing list