CIAO documentation features that users liked best
Back to the Survey
9 - threads
12 - ahelp and the threads.
13 - The threads are fantastic
23 - The threads are really spectacular.
27 - again, what CIAO documentation?
28 - Threads and ahelp files are usually fine.
30 - the universality of ahelp
32 - The threads are incredibly useful.
38 - It has to be the threads and ahelp -- once they are correct
of course, which many times does not seem to be the case
39 - Almost everything is there in the document.
40 - analysis threads
43 - ahelp files are good for details when you already know what to run
(though the see also seems to list too much)
multiple formats; sometimes I like to browse, sometimes I like to
print and markup (so the pdf version is a nice feature)
47 - The threads are very useful for unfamiliar tasks.
49 - Ahelp pages on any ciao command.
51 - data products guide
58 - ahelp's ease of access, apropos capability, uniformity.
59 - Threads!
60 - It is easy to obtain the documentation.
63 - The threads are really nice.
64 - I like the ease of getting to tool description quickly in ahelp.
I wish there were about 4 times as many examples included in the ahelp,
and more thorough descriptions of each parameter (including multiple examples of
possible values).
67 - The Theads web page is very useful to get started in CIAO-based
Chandra data analysis.
69 - The threads are very useful, and what I have looked at most often
after the ahelp pages. I suspect I would have used the Analysis Guide
a lot more had it existed when I first started working on chandra
data.
70 - Threads.
75 - threads for common user tasks
80 - The manuals on the website, particularly the threads since they are very succinct
81 - threads are the most effective documentation component
82 - Threads
83 - threads
84 - examples
89 - Threads
90 - ahelp seems to be very complete.
99 - threads and ahelp, as mentioned above.
103 - ahelp is still the best way to get info.
105 - The presence of examples, the remainder to related problems and/or
analysis aspects.
106 - The threads
108 - threads
113 - Threads
115 - none of them
119 - very well organized for on-line use
I like the threads section
121 - ahelp
124 - Threads are OK, but they need more real-world examples. They often
do a simple example (which is good, gets you started), but then
don't do any more realistic examples. For example: lightcurve
filtering (1 chip). Real world example: I have an ACIS observation
with 6 chips: how do I lightcurve filter on each chip separately
and recombine the results?
Similarly for dealing with sky background: how do I construct
sky background datasets for all the chips, merge everything back
into a single event list, and have all the GTI's, etc., set up
correctly? I think there need to be many more examples like the
step-by-step multi-chip exposure map thread. Lots more examples
of how to do it with more than one of whatever it is.
125 - Threads
126 - The threads are quite good.
Back to the Survey
