Tool support for executable documentation of Java class hierarchies

While object-oriented programming offers great solutions for today's software developers, this success has created difficult problems in class documentation and testing. In Java, two tools provide assistance: Javadoc allows class interface documentation to be embedded as code comments and JUnit supports unit testing by providing assert constructs and a test framework. This paper describes JUnitDoc, an integration of Javadoc and JUnit, which provides better support for class documentation and testing. With JUnitDoc, test cases are embedded in Javadoc comments and used as both examples for documentation and test cases for quality assurance. JUnitDoc extracts the test cases for use in HTML files serving as class documentation and in JUnit drivers for class testing. To address the difficult problem of testing inheritance hierarchies, JUnitDoc provides a novel solution in the form of a parallel test hierarchy. A small controlled experiment compares the readability of JUnitDoc documentation to formal documentation written in Object-Z. Copyright (c) 2005 John Wiley & Sons, Ltd.

Comparative cost-effectiveness of policy instruments for reducing the global burden of alcohol, tobacco and illicit drug use

Alcohol, tobacco and illicit drug use together pose a formidable challenge to international public health. Building on earlier estimates of the demonstrated burden of alcohol, tobacco and illicit drug use at the global level, this review aims to consider the comparative cost-effectiveness of evidence-based interventions for reducing the global burden of disease from these three risk factors. Although the number of published cost-effectiveness studies in the addictions field is now extensive ( reviewed briefly here) there are a series of practical problems in using them for sector-wide decision making, including methodological heterogeneity, differences in analytical reference point and the specificity of findings to a particular context. In response to these limitations, a more generalised form of cost-effectiveness analysis (CEA) is proposed, which enables like-with-like comparisons of the relative efficiency of preventive or individual-based strategies to be made, not only within but also across diseases or their risk factors. The application of generalised CEA to a range of personal and non-personal interventions for reducing the burden of addictive substances is described. While such a development avoids many of the obstacles that have plagued earlier attempts and in so doing opens up new opportunities to address important policy questions, there remain a number of caveats to population-level analysis of this kind, particularly when conducted at the global level. These issues are the subject of the final section of this review.

On the absolute calibration of bench-top small-angle X-ray scattering instruments: a comparison of different standard methods

Absolute calibration relates the measured (arbitrary) intensity to the differential scattering cross section of the sample, which contains all of the quantitative information specific to the material. The importance of absolute calibration in small-angle scattering experiments has long been recognized. This work details the absolute calibration procedure of a small-angle X-ray scattering instrument from Bruker AXS. The absolute calibration presented here was achieved by using a number of different types of primary and secondary standards. The samples were: a glassy carbon specimen, which had been independently calibrated from neutron radiation; a range of pure liquids, which can be used as primary standards as their differential scattering cross section is directly related to their isothermal compressibility; and a suspension of monodisperse silica particles for which the differential scattering cross section is obtained from Porod's law. Good agreement was obtained between the different standard samples, provided that care was taken to obtain significant signal averaging and all sources of background scattering were accounted for. The specimen best suited for routine calibration was the glassy carbon sample, due to its relatively intense scattering and stability over time; however, initial calibration from a primary source is necessary. Pure liquids can be used as primary calibration standards, but the measurements take significantly longer and are, therefore, less suited for frequent use.

I don't see me like you see me, but is that a problem? Cultural influences on rating discrepancy in 360-degree feedback instruments

360-degree feedback from a variety of rater sources yields important information about leaders' styles, strengths and weaknesses for development. Results where observer ratings are discrepant (i.e., different) from self-ratings are often seen as indicators of problematic leadership relationships, skills, or lack of self-awareness. Yet research into the antecedents of such self-observer rating discrepancy suggests the presence of systematic influences, such as cultural values. The present study investigates the variation of rating discrepancies on three leadership skills (decision making, leading employees, and composure) in dependence of one exemplary culture dimension (power distance) on data from 31 countries using multilevel structural equation modelling. Results show that cultural values indeed predict self-observer rating discrepancies. Thus, systemic and contextual influences such as culture need to be taken into consideration when interpreting the importance and meaning of self-observer rating discrepancies in 360-degree instruments.

Quality of life instruments in studies of menorrhagia: a systematic review

BACKGROUND: The use of quality of life (QoL) instruments in menorrhagia research is increasing but there is concern that not enough emphasis is placed on patient-focus in these measurements, i.e. on issues which are of importance to patients and reflect their experiences and concerns (clinical face validity). The objective was to assess the quality of QoL instruments in studies of menorrhagia. STUDY DESIGN: A systematic review of published research. Papers were identified through MEDLINE (1966-April 2000), EMBASE (1980-April 2000), Science Citation Index (1981-April 2000), Social Science Citation Index (1981-April 2000), CINAHL (1982-1999) and PsychLIT (1966-1999), and by manual searching of bibliographies of known primary and review articles. Studies were selected if they assessed women with menorrhagia for life quality, either developing QoL instruments or applying them as an outcome measure. Selected studies were assessed for quality of their QoL instruments, using a 17 items checklist including 10 items for clinical face validity (issues of relevance to patients' expectations and concerns) and 7 items for measurement properties (such as reliability, responsiveness, etc.). RESULTS: A total of 19 articles, 8 on instrument development and 11 on application, were included in the review. The generic Short Form 36 Health Survey Questionnaire (SF36) was used in 12/19 (63%) studies. Only two studies developed new specific QoL instruments for menorrhagia but they complied with 7/17 (41%) and 10/17 (59%) of the quality criteria. Quality assessment showed that only 7/19 (37%) studies complied with more than half the criteria for face validity whereas 17/19 (90%) studies complied with more than half of the criteria for measurement properties (P = 0.0001). CONCLUSION: Among existing QoL instruments, there is good compliance with the quality criteria for measurement properties but not with those for clinical face validity. There is a need to develop methodologically sound disease specific QoL instruments in menorrhagia focussing both on face validity and measurement properties.