Colin Putney wrote:
Aha, that makes sense. So you'd like to see a plain SAR as well as the ZIP? I had hoped to have a single distribution, but perhaps that's not feasible. The text files that are included now aren't a big deal, but I plan to add a directory of HTML documentation as well. Here's some options:
- Have separate downloads for users and integrators. The user-oriented
artefact would be a ZIP file similar to the one in 2.0.3, while the integrator-oriented artefact would be a SAR with just the code.
Define "user-oriented artifact" ;-) I'm not exactly used to download zip files containing Smalltalk source any longer. I haven't used those file-ins forever, and instead I go straight to Universes, Squeaksource, Installer or Squeak Map.
- Have a single SAR that includes the documentation as well as the
code. Installing would write the documentation out to disk.
- Have the documentation reside on the web, and just include a URL in
the SAR.
- Have some sort of in-image documentation rather than HTML.
Thoughts?
Easy answer: When was the last time that you've actually went to the disk to find some documentation instead of typing it straight into Google? I find myself typing "man chmod" into Google! ;-)
Seriously, put it online. It's where it belongs, it's where people will look for it, it's where they expect to find it. It also means you can add a wiki for user comments (I *really* like the PHP documentation for that - there is always a user-contributed example to everything).
Cheers, - Andreas