Discussion:
Squeak Documentation, lack thereof
(too old to reply)
Doug Telford
2015-12-01 03:24:24 UTC
Permalink
From the few benchmarks that I have run, Squeak looks very promising.

However, it is very difficult to tell what Squeak is, due to the lack of documentation.

Squeak by example is more than 6 years old, and only by a stretch of the imagination may it be called a user's guide.
It certainly is not a reference manual. Other documentation seems very dated.

Commercial products ( such as VisualWorks ) provide a lot of documentation, at a price (or free if you use their non commercial version). Maybe Squeak has comparable functionality to VisualWorks, but it is difficult to tell.

It seems to me that Squeak development has far outrun the documentation and only the developers know the true capabilities of the product.
gargoyle60
2015-12-01 13:29:12 UTC
Permalink
Post by Doug Telford
From the few benchmarks that I have run, Squeak looks very promising.
However, it is very difficult to tell what Squeak is, due to the lack of documentation.
Squeak by example is more than 6 years old, and only by a stretch of the imagination may it be called a user's guide.
It certainly is not a reference manual. Other documentation seems very dated.
Commercial products ( such as VisualWorks ) provide a lot of documentation, at a price (or free if you use their non commercial version). Maybe Squeak has comparable functionality to VisualWorks, but it is difficult to tell.
It seems to me that Squeak development has far outrun the documentation and only the developers know the true capabilities of the product.
Agreed. As a keen VisualWorks developer I too would like to extend my usage of Smalltalk into
Squeak, but I don't see it as an especially viable product.

Without the benefit of comprehensive documentation, with good examples, then I continue to view
Squeak as being too toy-like for my immediate benefit.

Loading...