Intraprogram documentation

Three kinds of documentation are examined: summary documentation describes the intent and nature of the program; detail documentation gives all the information the user needs to put the program to work; intraprogram documentation is information written into the program to inform the user or programmer. The need for intraprogram documentation occurs at four different times: in the initial design period; during debugging; as the program and system evolve; when it is necessary to adapt the program to other systems There are several means for providing intraprogram documentation. There are comments which can be placed in the header, on each line, at the beginning and end of a subroutine. Also noted is the important use of space for making the comments easier to read and for separating chunks of the program. Special symbols serve the same purpose. Examples are provided to bring home these points.     

机械制图CAI课件的设计与实现

根据制图教学特点,论述了机构制图CAI课件的设计思想、实现过程,它的创意及表现方式对于制图CAI课件的开发及应用研究将起到积极的推动作用。     

水电厂电子图档仿真培训系统设计与开发

在总结水电厂工作经验的基础上,针对水电厂设备资料管理和人员培训中存在的问题,结合最新信息技术提出了水电厂电子图档仿真培训系统的体系结构,并对系统实现中的关键技术进行分析,建立了虚拟仿真模型并开发了应用软件.软件运行结果表明,系统具有良好的人机交互功能,为电站人员培训提供了更完善的手段.     

《释氏六帖》引《古今注》的文献价值

要五代义楚编撰的《释氏六帖》引用了许多《古今注》释义,这与今通行本《古今注》多有出入,本文从辨伪、版本、辑佚、校勘四个方面入手,分析了其征引情况,认为《释氏六帖》所引《古今注》具有不可替代的文献价值。     

The documentation of product configuration systems: A framework and an IT solution

When designing and maintaining a product configuration system (PCS), complete and up-to-date documentation of the system is needed in the form of a product model that outlines the structures, attributes, and constraints of the PCS. Furthermore, up-to-date documentation for the PCS is crucial for maintenance, further development, system quality and communication with domain experts. Product models are the main communication and documentation tools used in PCS projects. Recent studies have shown that up-to-date documentation for the PCS is often lacking due to the significant amount of work required to maintain product models. To address these challenges, this paper proposes an approach for documenting the PCS that is based on the structure, attributes, and constraints modelled within the PCS, in which the product model is generated directly from the PCS. The suggested approach avoids knowledge duplication, as knowledge needs to be maintained within the PCS only. It involves two steps: the first is the building of the initial product model, which is used for the programming of the PCS. In the second step, the product model is generated directly from the PCS and is based on the structure, attributes, and constraints inside the PCS. The product model does not need to be maintained, therefore, outside the PCS. This approach meets the demand for agile documentation and efficient communication with domain experts, and uses the fewest resources possible. Furthermore, to support the framework, an IT documentation system is proposed that is capable of retrieving knowledge from the PCS and thus generating the product model. Our framework and IT documentation system were developed and tested at a case company on five different projects. The results confirm that benefits can be achieved by using the proposed IT documentation system, as time and resources are saved, while the quality of the PCS is improved.     

关于软件测试执行过程的探讨

软件测试是保证软件质量的重要手段,论文着重从软件测试执行过程的管理方面,结合实际工作进行了一些探讨,并对实践中经常出现的问题进行了总结和分析.同时,对我国当前软件测试过程的现状进行了简要说明.     

Evolution of a maturity model – critical evaluation and lessons learned

A system documentation process maturity model and assessment procedure were developed and used to assess 78 projects at 28 different companies over a five year period. During this time the original version evolved into second and third versions based on feedback from industry and the experience gained from the assessments. The changes to the model, maturity levels, key practices, scoring scheme and assessment report, and the reasons behind these changes are analyzed in this paper. The biggest lesson learned is that the key practices' degree of satisfaction and not the maturity levels drive the assessment and provide the key information needed for process improvement.     

Recent trends in legal bibliographical documentation

We discuss the development of factual and bibliographical databases and database systems, including management systems and information retrieval systems. Special reference is made to the International Bibliography on Computers and Law, with respect to both the current situation and future plans. Rosa Maria Di Giorgi has, since 1982, been a researcher at the Instituto per la Documentazione Giuridica of Florence of the Italian National Research Council. She took her degree in Letters and Philosophy at the University of Florence in 1979 and has completed an advanced course in computer applications. Her research activity concentrates on legal informatics and on advanced automated legal documentary systems and advisory legal expert systems. She is an editor of Informatica e Dirrito and of the International Bibliography on Computers and the Law.     

Transformations of normal and inverted function tables

We develop a theory of function tables, similar to, and inspired by, that given in the work of D. Parnas. We consider, in particular, two classes of function tables: normal and inverted. We study effective transformations between tables of these two classes, as well as transformations which change the dimension of a table. We also consider the interrelationship between these three types of transformation.