The suitability of written education materials for stroke survivors and their carers

This study evaluated the suitability of written materials for stroke survivors and their carers. Twenty stroke survivors and 14 carers were interviewed about the stroke information they had received and their perceptions of the content and presentation of materials of increasing reading difficulty. The mean readability level of materials (grade 9) was higher than participants’ mean reading ability (grade 7–8). Satisfaction with materials decreased as the content became more difficult to read. Seventy-five percent reported that their information needs were not met in hospital. More stroke survivors with aphasia wanted support from health professionals to read and understand written information, and identified simple language, large font size, color, and diagrams to complement the text as being important features of written materials. Simple materials that meet clients’ information needs and design preferences may optimally inform them about stroke.

The effectiveness of aphasia-friendly principles for printed health education materials for people with aphasia following stroke

Background: Provision of health information to people with aphasia is inadequate. Current practice in providing printed health education materials to people with aphasia does not routinely take into consideration their language and associated reading difficulties. Aims: This study aimed to investigate if people with aphasia can comprehend health information contained in printed health education materials and if the application of aphasia-friendly principles is effective in assisting them to comprehend health information. It was hypothesised that participants with aphasia would comprehend significantly more information from aphasia-friendly materials than from existing materials. Other aims included investigating if the effectiveness of the aphasia-friendly principles is related to aphasia severity, if people with aphasia are more confident in responding to health information questions after they have read the aphasia-friendly material, if they prefer to read the aphasia-friendly brochures, and if they prefer to read the brochure type that resulted in the greatest increase in their knowledge. Methods & Procedures: Twelve participants with mild to moderately severe aphasia were matched according to their reading abilities. A pre and post experimental design was employed with repeated measures ANOVA (p

API documentation with executable examples

The rise of component-based software development has created an urgent need for effective application program interface (API) documentation. Experience has shown that it is hard to create precise and readable documentation. Prose documentation can provide a good overview but lacks precision. Formal methods offer precision but the resulting documentation is expensive to develop. Worse, few developers have the skill or inclination to read formal documentation. We present a pragmatic solution to the problem of API documentation. We augment the prose documentation with executable test cases, including expected outputs, and use the prose plus the test cases as the documentation. With appropriate tool support, the test cases are easy to develop and read. Such test cases constitute a completely formal, albeit partial, specification of input/output behavior. Equally important, consistency between code and documentation is demonstrated by running the test cases. This approach provides an attractive bridge between formal and informal documentation. We also present a tool that supports compact and readable test cases; and generation of test drivers and documentation, and illustrate the approach with detailed case studies. (C) 2002 Elsevier Science Inc. All rights reserved.