Standards and tools in production and maintenance of system documentation
Implementation of a standard in a software development or maintenance process will provide guidelines on how to conduct the activities in the phases of software life cycle including the documentation to be produced. In addition, the use of Computer-Aided Software Engineering tools or workbenches can...
| Main Authors: | , , |
|---|---|
| Format: | Article |
| Language: | English |
| Published: |
Penerbit UTM Press
2005
|
| Subjects: | |
| Online Access: | http://eprints.utm.my/83/ http://eprints.utm.my/83/1/ShamsulSahibUddin2005_StandardsAndToolsInProduction.pdf |
| _version_ | 1848889843270025216 |
|---|---|
| author | Sulaiman, Shahida Idris, Norbik Bashah Uddin, Shamsul Sahib |
| author_facet | Sulaiman, Shahida Idris, Norbik Bashah Uddin, Shamsul Sahib |
| author_sort | Sulaiman, Shahida |
| building | UTeM Institutional Repository |
| collection | Online Access |
| description | Implementation of a standard in a software development or maintenance process will provide guidelines on how to conduct the activities in the phases of software life cycle including the documentation to be produced. In addition, the use of Computer-Aided Software Engineering tools or workbenches can automate parts of documenting activities. Despite the importance of standard and tools to be utilised, they are still not widely used. Thus, software engineers still confront with the problems related to documentation particularly system documentation. This paper presents the result of a survey in Malaysia with the main goal to study software engineers' current practice in production and maintenance of documentation based on characteristic, behavior, belief and attitude. Finally, we highlight on what kind of tools should be introduced, why it is introduced and when or how it should be introduced to support the practice.
ABSTRAK;
Pelaksanaan sesuatu piawai di dalam proses pembangunan atau pengubahsuaian akan menghasilkan garis panduan bagaimana menjalankan aktivitiaktiviti di dalam fasa-fasa kitar hidup perisian termasuk dokumentasi yang perlu dihasilkan. Di sam ping itu juga, penggunaanalat kejuruteraan perisian berbantukan komputer atau 'workbenches' boleh mengautomasikan sebahagian daripada aktiviti-aktiviti dokumentasi dengan lebih piawai. Walaupun kepentingan piawai dan alat-alat tersebut boleh dimanfaatkan, tetapi pembangun sistem masih tidak menggunakannya secara meluas. Jurutera-jurutera perisian masih berhadapan dengan masalah-masalah berkaitan dengan dokumentasi terutamanya dokumentasi sistem. Rencana ini bertujuan untuk membentangkan hasil kaji selidik yang telah dijalankan di Malaysia. Matlamat utama kajian adalah untuk mengkaji amalan semasa juruterajurutera perisian di dalam penghasilan dan pengubahsuaian dokumentasi berdasarkan sifat, tingkah laku, kepercayaan dan sikap. Basil kajian juga dapat mengenat pasti apakah Jenis aoo yang perlu keMpllta diperkenalkan dan bila atau bagaimana ia harus diperkenalkan untuk menyokong amalan tersebut. |
| first_indexed | 2025-11-15T20:32:37Z |
| format | Article |
| id | utm-83 |
| institution | Universiti Teknologi Malaysia |
| institution_category | Local University |
| language | English |
| last_indexed | 2025-11-15T20:32:37Z |
| publishDate | 2005 |
| publisher | Penerbit UTM Press |
| recordtype | eprints |
| repository_type | Digital Repository |
| spelling | utm-832017-11-01T04:17:35Z http://eprints.utm.my/83/ Standards and tools in production and maintenance of system documentation Sulaiman, Shahida Idris, Norbik Bashah Uddin, Shamsul Sahib QA76 Computer software Implementation of a standard in a software development or maintenance process will provide guidelines on how to conduct the activities in the phases of software life cycle including the documentation to be produced. In addition, the use of Computer-Aided Software Engineering tools or workbenches can automate parts of documenting activities. Despite the importance of standard and tools to be utilised, they are still not widely used. Thus, software engineers still confront with the problems related to documentation particularly system documentation. This paper presents the result of a survey in Malaysia with the main goal to study software engineers' current practice in production and maintenance of documentation based on characteristic, behavior, belief and attitude. Finally, we highlight on what kind of tools should be introduced, why it is introduced and when or how it should be introduced to support the practice. ABSTRAK; Pelaksanaan sesuatu piawai di dalam proses pembangunan atau pengubahsuaian akan menghasilkan garis panduan bagaimana menjalankan aktivitiaktiviti di dalam fasa-fasa kitar hidup perisian termasuk dokumentasi yang perlu dihasilkan. Di sam ping itu juga, penggunaanalat kejuruteraan perisian berbantukan komputer atau 'workbenches' boleh mengautomasikan sebahagian daripada aktiviti-aktiviti dokumentasi dengan lebih piawai. Walaupun kepentingan piawai dan alat-alat tersebut boleh dimanfaatkan, tetapi pembangun sistem masih tidak menggunakannya secara meluas. Jurutera-jurutera perisian masih berhadapan dengan masalah-masalah berkaitan dengan dokumentasi terutamanya dokumentasi sistem. Rencana ini bertujuan untuk membentangkan hasil kaji selidik yang telah dijalankan di Malaysia. Matlamat utama kajian adalah untuk mengkaji amalan semasa juruterajurutera perisian di dalam penghasilan dan pengubahsuaian dokumentasi berdasarkan sifat, tingkah laku, kepercayaan dan sikap. Basil kajian juga dapat mengenat pasti apakah Jenis aoo yang perlu keMpllta diperkenalkan dan bila atau bagaimana ia harus diperkenalkan untuk menyokong amalan tersebut. Penerbit UTM Press 2005 Article PeerReviewed application/pdf en http://eprints.utm.my/83/1/ShamsulSahibUddin2005_StandardsAndToolsInProduction.pdf Sulaiman, Shahida and Idris, Norbik Bashah and Uddin, Shamsul Sahib (2005) Standards and tools in production and maintenance of system documentation. Jurnal Teknologi Maklumat dan Multimedia, 2 . pp. 81-103. ISSN 1823-0113 |
| spellingShingle | QA76 Computer software Sulaiman, Shahida Idris, Norbik Bashah Uddin, Shamsul Sahib Standards and tools in production and maintenance of system documentation |
| title | Standards and tools in production and maintenance of system documentation |
| title_full | Standards and tools in production and maintenance of system documentation |
| title_fullStr | Standards and tools in production and maintenance of system documentation |
| title_full_unstemmed | Standards and tools in production and maintenance of system documentation |
| title_short | Standards and tools in production and maintenance of system documentation |
| title_sort | standards and tools in production and maintenance of system documentation |
| topic | QA76 Computer software |
| url | http://eprints.utm.my/83/ http://eprints.utm.my/83/1/ShamsulSahibUddin2005_StandardsAndToolsInProduction.pdf |