The benefits provided by Bullfighter software introduced by Deloitte Consulting to improve documentation writing, are discussed. Once downloaded and installed, Bullfighter appears as a small toolbar in Microsoft Word ...
详细信息
The benefits provided by Bullfighter software introduced by Deloitte Consulting to improve documentation writing, are discussed. Once downloaded and installed, Bullfighter appears as a small toolbar in Microsoft Word and PowerPoint. It works with Word and PowerPoint to help eliminate jargon from writing. The Bullfighter Web site is running its own version of March Madness, the 2005 Manure Madness Annual Bull Tournament. Meanwhile, the requirements of Bullfighter 1.2 are minimal such as Office 2000 of Office XP, Windows 2000 or Windows XP, and a PC. Bullfighter enables the shortening of several sentences thus, providing accuracy to the number of syllables in a document.
For most of the technical writing community, task-based documentation has become the panacea for presentation of end-product document (in any of its myriad forms including traditional linear manuals and online help). ...
详细信息
ISBN:
(纸本)1891709178
For most of the technical writing community, task-based documentation has become the panacea for presentation of end-product document (in any of its myriad forms including traditional linear manuals and online help). We believe, however, that applying this method to a complex tool, (for example, a software tool without a Graphical User Interface), challenges the task-based approach. In this paper, we examine the scalability of the task-based approach vis-a-vis a complex tool, examine the unique challenges of documenting a complex tool, and suggest methods technical writer can consider when deciding their documentation approach.
documentation is an integral part of a software system. It contains the information that is necessary to effectively and successfully develop, use, and maintain a system. In practice, however, the creation Of appropri...
详细信息
ISBN:
(纸本)0769525466
documentation is an integral part of a software system. It contains the information that is necessary to effectively and successfully develop, use, and maintain a system. In practice, however, the creation Of appropriate documentation is largely neglected. This paper investigates the reasons for this neglect, presents view-based software documentation, our approach to improve the current situation, and reports on empirical evidence in support of the presented approach. Because the quality of documentation depends on its usage, view-based software documentation exploits existing software modeling techniques to provide all users of documentation with the documentation they require for performing their tasks. View-based software documentation has been empirically validated in a series of experiments and case studies that showed that the approach improves the completeness, correctness, and usefulness of produced and maintained documentation. One of the experiments is described here in more detail.
Software development relies heavily on reusable libraries and software components. For correct use of the provided API, proper documentation is needed. API usage is often demonstrated by giving example applications an...
详细信息
ISBN:
(纸本)9780769528601
Software development relies heavily on reusable libraries and software components. For correct use of the provided API, proper documentation is needed. API usage is often demonstrated by giving example applications and code samples. In this paper we propose an approach for mining such usage scenarios from run-time communication between sample applications and the API. This is done automatically by first monitoring the API usage of sample applications, then filtering the generated traces, and finally synthesizing the sequence diagrams and illustrating them in a well-formed way as UML2 sequence diagrams. Such usage scenarios support the software engineer in comprehending the usage of the API. With proper tool support they can also be used for validating other applications' AN usage and for generating code for a new application using the same API.
In multicluster systems, and more generally, in grids, jobs may require co-allocation. i.e., the simultaneous allocation of resources such as processors and input files in multiple clusters. While such jobs may have r...
详细信息
ISBN:
(纸本)0780386949
In multicluster systems, and more generally, in grids, jobs may require co-allocation. i.e., the simultaneous allocation of resources such as processors and input files in multiple clusters. While such jobs may have reduced runtimes because they have access to more resources, waiting for processors in multiple clusters and for the input files to become available in the right locations may introduce inefficiencies. In previous work we have studied through simulations only processor co-allocation. Here, we extend this work with an analysis of the performance in a real testbed of out prototype Processor and Data Co-Allocator with the Close-to-Files (CF) job-placement algorithm. CF tries to place job components on clusters with enough idle processors which are close to the sites where the input files reside. We present a comparison of the perfomance of CF and the Worst-Fit job-placement algorithm, with and without file replication, achieved with our prototype. Our most important findings are that CF with replication works best. and that the utilization in our testbed call be driven to about 80%.
Ordering information is a critical task for multi-document summarization(MDS) because it heavily influent the coherence of the generated summary. In this paper, we propose a hybrid model for sentence ordering in extra...
详细信息
ISBN:
(纸本)3540454853
Ordering information is a critical task for multi-document summarization(MDS) because it heavily influent the coherence of the generated summary. In this paper, we propose a hybrid model for sentence ordering in extractive multi-document summarization that combines four relations between sentences - chronological relation, positional relation, topical relation and dependent relation. This model regards sentence as vertex and combined relation as edge of a directed graph on which the approximately optimal ordering can be generated with PageRank analysis. Evaluation of our hybrid model shows a significant improvement of the ordering over strategies losing some relations and the results also indicate that this hybrid model is robust for articles with different genre.
We report on experiments in adapting document categorization techniques to provide for implementation in high-speed hardware.(1,2) Because resources are scarce, it is important to have a small set of robust and maxima...
详细信息
ISBN:
(纸本)0780388690
We report on experiments in adapting document categorization techniques to provide for implementation in high-speed hardware.(1,2) Because resources are scarce, it is important to have a small set of robust and maximally informative variables over which learning can occur. We generate variables using information-theoretic clustering. The resulting performance is on par with general-purpose computing implementations which are able to take advantage of large amounts of time and memory. We conclude that custom high-speed hardware for document categorization can be made very accurate. We also believe that some of the strengths of information-theoretic data analysis techniques are brought out.
This paper investigates commonalities and differences between Agile and documentation-driven approaches in managing uncertainty in requirement gathering. The research method is a survey collected interviewing sixteen ...
详细信息
ISBN:
(纸本)0769526918
This paper investigates commonalities and differences between Agile and documentation-driven approaches in managing uncertainty in requirement gathering. The research method is a survey collected interviewing sixteen project managers of Italian software companies, 8 using Agile Methods, and 8 using documentation-driven methods. The results show that Agile and Document-driven companies consider in a different way the problem of changing requirements and the related uncertainty: thus, they manage differently requirements gathering and the relationship with the customer.
Living guidelines are documents presenting up-to-date and state-of-the-art knowledge to practitioners. To have guidelines implemented by computer-support they firstly have to be formalized in a computer-interpretable ...
详细信息
ISBN:
(纸本)9783540735984
Living guidelines are documents presenting up-to-date and state-of-the-art knowledge to practitioners. To have guidelines implemented by computer-support they firstly have to be formalized in a computer-interpretable form. Due to the complexity of such formats the formalization process is challenging, but burdensome and time-consuming. The LASSIE methodology supports this task by formalizing guidelines in several steps from the textual form to the guideline representation language Asbru using a document-centric approach. LASSIE uses Information Extraction technique to semi-automatically accomplish these steps. We apply LASSIE to support the implementation of living guidelines. Based on a living guideline published by the Scottish Intercollegiate Guidelines Network (SIGN) we show that adaptations of previously formalized guidelines can be accomplished easily and fast. By using this new approach only new and changed text parts have to be modeled. Furthermore, models can be inherited from previously modeled guideline versions that were added by domain experts.
暂无评论