 |
 |
It may be a good idea to put some more info in the package overview in the javadocs - maybe from the "What is STIL" paragraph. It may be a good idea to emphasise in that para the fact that you can (albeit to be improved in future) join tables. By the way there is no mention of search/sort - shouldn't that be part of STIL? Cheers ...David > -----Original Message----- > From: Alasdair Allan [mailto:[log in to unmask]] > Sent: 27 January 2004 18:50 > To: [log in to unmask] > Subject: Re: Tables infrastructure > > > If any of you (Peter and Al as potential customers especially?) > > have comments I'd be grateful to hear them; you can find the web page at > > > > http://andromeda.star.bris.ac.uk/~mbt/stil/ > > > > with links to the user document (SUN/252) and javadocs. > > Okay, a couple of (silly?) points about the web page in this email, I'll > actually sit down and look at it properly tommorrow! > > Right at the start you need to emphasis right under where it says > "Starlink Tables Infrastructure Library" that this is Java, pure Java, and > not Fortran (no Fortan anywhere). Maybe a subtitle it like, > > Starlink Tables Infrastructure Library > <EM><FONT SIZE="-1">Generic Java Table Handling for > Astronomy</FONT></EM> > > we do have a reputation for producing Java that you need JNI to use. Might > be a good presentation idea to hammer it home that this one is a bit > different? A small point, but presentation sometimes wins over content > (unfortunately), someething we've been guilty of forgetting in the past. > > Along the same lines you probably want a bold text list right up front of > what formats it handles (or at least bold them in the intro paragraph), so > move the "Supported Formats" section up the text and bold face it! > > In the "How to obtain it" you want to put the link to the standalone JAR > file first and emphasis that STIL doesn't need any of the rest of the > Starlink stuff to run (it has a minimal buy-in and thats a BIG plus point > you need to sell). > > All the important stuff (supported formats, how to get it) should be near > the top so you don't have to scroll to get to them. > > Cheers, > Al.