CIAO documentation features that users liked best
Back to the Survey9 - 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